Skip to content

How to import and export products

CSV import and export from the Products page header, processed in a queue.

Overview

Import and export are not in the sidebar. On Inventory → Products, use the Import / Export dropdown: Import Products, Export Products, Export Queues.

Before you start

  • CSV column order is fixed. Extra columns in the wrong place will be misread.
  • Image URLs must be HTTPS Store Rav file URLs (your existing asset/product images), pipe-separated if there are several.
  • Import does not include options, variants, attributes, ribbons, listing, stock, or per-channel price/status overrides.

How to use it

Import

  1. Inventory → Products → Import / Export → Import Products.
  2. Upload a CSV (comma, tab, semicolon, or | delimiter is detected).
  3. Optionally enable matching images from the media library by product name if that checkbox is shown (auto link media).
  4. Submit. Processing runs in the background. Open import queues to watch status and errors. You may receive an email when it finishes.

Required header order:

  1. Name
  2. Initial Price
  3. Price
  4. Categories
  5. Summary
  6. Description
  7. SKU
  8. Status
  9. Image URLs

Optional: Sales Channels (may be omitted entirely from the file)

  • Name is the product name.
  • Categories are comma-separated; missing categories are created.
  • Status is active only if the cell is active; otherwise the product is inactive.
  • Invalid price becomes 0.
  • Sales Channels (optional): comma-separated channel availability. Leave blank for all implemented channels (Hosted Shopfront, Kiosk, QR Ordering). Use each channel’s type code (same values as SalesChannelType in the API — the Import page lists the current codes). Matching is case-insensitive. Unknown or unsupported tokens are skipped; warnings appear on the import queue Errors list. Import does not set channel price or status overrides.

Export

  1. Export Products for the current list scope (all, or selected products up to 100 when exporting a filtered set).
  2. Watch Export Queues. When completed, download the file.
  3. You may receive an email when the export is ready.

The export CSV uses the nine core import columns (through Image URLs), with public image URLs pipe-separated. The optional Sales Channels column is import-only and is not included in exports.

Important

  • After import, open each product to adjust Channels (price/status overrides if needed), Gallery (if images failed), Variants, and Attributes.
  • Large files run in a queue. Do not assume the list updates instantly.

Common problems

Problem

Import finished but products have no images.

Possible causes

  • URLs were not Store Rav HTTPS asset URLs.
  • Column order was wrong so Image URLs did not land in the correct column.

Solution

Fix the CSV, re-import, or upload images on the Gallery tab.

Problem

Variants did not import.

Solution

Expected. Recreate options after import.

Problem

Import queue shows Channel warning messages for Sales Channels.

Possible causes

  • Values were not valid implemented channel type codes (see Import page for the current list).
  • A token such as pos is not supported on import yet.

Solution

Fix the Sales Channels column in the CSV and re-import new products, or set Channels on each product in the dashboard. A blank cell means all implemented channels.