Articles on: Product Groups & Options

Single-option CSV Import and Export — Image Source Update (Draft 2026-07-30)

Download the import template first

Sample CSV

The latest single-option CSV template contains these columns:

Group Name
Option Style in Product Page
Product Handle
Option Name
Option Value
Swatch Color Code / Image URL
Image Source (optional)

CSV format

Column descriptions

Group Name

Group Name is the unique identifier of a group. Give products in the same group the same group name.

Option Style in Product Page

Leave this column blank to use the system default template, or enter a template name to choose a template for the group.

Template name

Product Handle

Enter the Shopify product handle.

Product handle

Option Name and Option Value

Enter the option name and the option value displayed for that product.

Option name

Swatch Color Code / Image URL

For button or dropdown templates, leave this column blank.
For color-swatch templates, enter a valid color such as red or #000000.
For image-swatch templates, use this column together with Image Source as described below.

Image Source (optional)

For a single-option image-swatch template, the supported values are:

Value	Swatch behavior	Swatch Color Code / Image URL
`FIRST`	Tracks Product image 1 in Shopify.	Leave blank.
`SECOND`	Tracks Product image 2 in Shopify.	Leave blank.
`CUSTOM`	Uses a fixed custom image.	A valid public image URL is required.

Values are case-insensitive. Unsupported values cause the row to fail validation.

For backward compatibility, old six-column CSV files are still supported:

A blank Image Source with a blank image URL is treated as FIRST.
A blank Image Source with an image URL is treated as CUSTOM.

If SECOND is selected but the product has only one image, Product image 1 is displayed as a fallback. The source remains SECOND, so adding a second product image later updates the swatch automatically.

Export behavior

Single-option exports include the same Image Source column:

FIRST and SECOND rows export an empty Swatch Color Code / Image URL value and preserve the dynamic source in Image Source.
CUSTOM rows export both the fixed image URL and CUSTOM.

This allows an export to be imported again without turning Product image 1 or Product image 2 into a fixed image URL.

Subcategory CSV exports use the same FIRST, SECOND, and CUSTOM rules. Multi-option XLSX imports and exports also include Image Source, with the values FIRST, PRODUCT, and CUSTOM.

Updated on: 30/07/2026

Was this article helpful?

Thank you!