Review and confirm a product import

Imports are staged before they change the catalog

Open Products and select Import catalog. Choose a CSV, XLS, or XLSX file. The panel reads the file into a private staged import so you can review mapping, rows, warnings, and errors before the active catalog changes.

The import flow has four steps: File, Review, Confirm, and Import. While the file is being prepared, the panel states that the active catalog has not changed.

Review mapping and rows

On the Review step, check the detected column mapping and the validation summary. The panel can show counts for valid rows, warning rows, and error rows. Mapping changes require another validation pass.

You can search the import, filter by validation state or change type, and inspect each row’s uploaded value, issue details, and suggested fix. If a field should not influence the agent, use the available Hide from AI action. If a row should not be imported, exclude it and keep track of the excluded-row count.

For small corrections, edit the row and select Save edit. To restore the uploaded value, select Reset to uploaded value. For repeated data, use Bulk fill, choose the scope, and apply the value to selected, filtered, or all rows. Select Undo last edit when the last change was accidental.

Use Validate changes after editing. Do not continue while required errors remain unless the panel explicitly lets you exclude or correct them.

Decide how the file joins the catalog

On Confirm, choose the impact that matches your intention:

Option	What it does
Merge with catalog	Adds new products, updates matching products, and keeps products that are not present in the file.
Replace catalog	Removes the current catalog and uses only the validated file.

The panel shows the expected new, updated, unchanged, and removed products before you confirm. A merge can still show deletions when rows were explicitly removed from the staged import. Review that warning carefully.

Replace is protected by a confirmation phrase. Type the phrase exactly as shown before the Replace catalog action becomes available. If the catalog is empty, the panel explains that the first upload creates products and there is nothing to replace.

Confirm and follow the result

Select Import products or Replace catalog. The final result reports how many products were saved and whether image URLs were detected or queued for processing. Product data can become available before image processing finishes.

If the import is interrupted, the panel can offer Return to review, Check again, View history, or Start another import. Use Review product import history to understand saved statuses and recovery actions. Use the saved import rather than uploading the same file repeatedly when the existing review is still available.

After a successful import, select View catalog, Manage images, or View history. Continue with Manage product images if the result reports missing or external images.