Import and export with CSV

Import

Open Groups → Import. Drop a CSV file (up to 2 MB) and click Import groups. A Download sample link in the modal gives you a ready-made template.

Drop a CSV file, or download the sample template to get the format right.

CSV format

One row per linked product. Rows with the same Group name become one group.

Group,Type,Status,Product ID,Option 1,Value 1,Option 2,Value 2
Summer Tee,single_option,active,7012345678901,Color,Red,,
Summer Tee,single_option,active,7012345678902,Color,Blue,,
Hoodie,multiple_options,draft,7012345670001,Color,Black,Size,M
Hoodie,multiple_options,draft,7012345670002,Color,Black,Size,L

Column	Required	Values
Group	✅	Group name. Rows sharing a name are combined into one group.
Type	Optional	single_option or multiple_options. Inferred from the number of options when omitted. Single-choice groups (sub_groups) are not supported via CSV.
Status	Optional	draft, active, or archived. Defaults to active.
Product ID	✅	Numeric Shopify product ID (e.g. 7012345678901) or the full gid://shopify/Product/… form.
Option 1, Value 1 …	✅ at least one pair	Option name + this product’s value. Up to 6 option/value pairs.

Limits and rules

• Max 1,000 rows, 50 columns, 6 options per group, names up to 255 characters.
• Create-only: import always creates new groups; it never updates or overwrites existing ones.
• A product already in a group (or listed under two groups in the same file) fails that group only — the rest of the file still imports.
• The result modal reports imported / failed counts with a per-row error list.

A row using an unsupported type (here, sub_groups) fails on its own — other groups in the same file still import.

Export

Export is not available in the app at the moment — there is no Export action on the Groups index. The format below describes what an export contains.

Exporting a selection of groups produces a summary file:

Group name,Status,Options,Variants,Linked products,Total products

The export format is a report, not the import format — an exported file can’t be re-imported as-is. Use Download sample in the import modal for the import template.

Was this helpful?

Report an issue