> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.linkedoption.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

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

## Download the import template first

![Sample CSV](https://helpkit.getalltool.com/api/media/file/image-76.png)

The latest single-option CSV template contains these columns:

1. `Group Name`
2. `Option Style in Product Page`
3. `Product Handle`
4. `Option Name`
5. `Option Value`
6. `Swatch Color Code / Image URL`
7. `Image Source` (optional)

![CSV format](https://helpkit.getalltool.com/api/media/file/image-77.png)

## 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](https://helpkit.getalltool.com/api/media/file/image-78.png)

### Product Handle

Enter the Shopify product handle.

![Product handle](https://helpkit.getalltool.com/api/media/file/image-79.png)

### Option Name and Option Value

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

![Option name](https://helpkit.getalltool.com/api/media/file/image-80.png)

### 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`.