Import Items in Bulk
Use Bulk Operations to import items, export item data, and submit large catalog edits in one place.
Who is this article for?
Use Bulk Operations to import catalog files, export items or edit many existing records. Review the scope and results carefully because an import can create or update items.
Open Bulk Operations
Go to Catalog Items → More actions → Bulk Operations.
Choose a Template
The CSV Import Format card links to All Types, Stock, Menu, Hybrid and Service templates and the CSV Format Guide. Start from the current template for the item types you need.
CSV rows are grouped by item ID when supplied, otherwise by item name. Multiple rows for the same item can represent different variations. Use consistent names and variation identities; accidental name matches can combine rows you intended as separate items.
Use JSON for complex variation and location structures. An exported file can retain IDs for updating existing items.
Import Files
Keep item and variation IDs when updating an exported catalog. Without a matching existing item ID, the import creates a new item. Matching names group rows within the CSV file; they do not select an existing catalog record for update. Large imports can be processed in batches, so a later failure does not mean earlier batches were undone.
Export Items
In Export Items, choose JSON or CSV and set the available status and location filters. Choose Export Items to download that scope.
Edit Existing Items
In Edit Existing Items, select item types, optionally set Filter by Tags, then choose Load Items. Expand the records, review changes and submit them together.
Use the regular item page for a one-off fix. Bulk editing and import share create-or-update behavior, so retain the correct IDs and review the result counts.
Make individual item edits Check recipes before importing complex variations