> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/swatch/options/set-color-and-image-swatches.md).

# Set color and image swatches

Give every option value a colour, a two-colour swatch, or an image.

Styles like **Color or custom image swatch** need to know what each value looks like — that "Red" is `#FF0000` and "Leopard" is a photo. That's what the value editor is for.

## Open the value editor

On **Options**, click **Set swatches** on the option you want to fill in, or **Complete setup** in its missing-values banner.

<figure><img src="https://3138853960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDsbeTbRNMPUo58YEXkMj%2Fuploads%2Fgit-blob-f1a7719c263250cb78a88e085bb627fc7753bd71%2Fimage%20(32).png?alt=media" alt=""><figcaption></figcaption></figure>

The page has two parts:

* **Options with swatches** on the left — every option that needs swatches, with how many values are **missing** and how many are **Ready**. Click one to switch to it.
* The value list on the right, headed with the option name and **Set a color or image swatch for each value.**

Each row shows the value's preview, its name, **Used by&#x20;*****n*****&#x20;products**, a **Status** of **Ready** or **Missing**, and the swatch controls.

## Set a value

Each row has a **1 color** / **2 colors** / **Image** switch under the column **Swatch type and content**. Pick one of the three, then fill in what it asks for.

**For color-swatch:** Click chip to select a color or enter the color hex to set up the color for swatch.

<figure><img src="https://3138853960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDsbeTbRNMPUo58YEXkMj%2Fuploads%2Fgit-blob-8dcf91521349526d1bac33315c02a04f6ff1b01d%2Fimage%20(30).png?alt=media" alt=""><figcaption></figcaption></figure>

**For two-color swatch:** Click **2 colors**. A second chip appears next to the first — set one colour in each, and the swatch is split between them. Two colours is the maximum; there is no third chip.

**For image-swatch:** Click **Image** tab, then select **Upload image**, or paste image URL in **Image URL** field

<figure><img src="https://3138853960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDsbeTbRNMPUo58YEXkMj%2Fuploads%2Fgit-blob-8c749f6eaa3e6ecd369af5dbf33d5cd40ecc4916%2Fimage%20(27).png?alt=media" alt=""><figcaption></figcaption></figure>

Click **Save** when you're done.

{% hint style="info" %}
**Setup tips**, shown on the page: use colours for simple values like Red or Black, and images for patterns, textures, or special finishes.
{% endhint %}

## Work through the missing ones

Turn on **Show missing only** to hide everything that's already set and work down the list. Use **Search for item** to jump to one value.

<figure><img src="https://3138853960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDsbeTbRNMPUo58YEXkMj%2Fuploads%2Fgit-blob-38a7de09de72bc9ad8edb22347cc50afa4e169db%2Fimage%20(31).png?alt=media" alt=""><figcaption></figcaption></figure>

## Keep your option values consistent

The app groups values by their exact text, across your whole catalog. "Navy" on one product and "navy" on another are treated as two different values, each needing its own swatch. Tidying up your product data in Shopify first means fewer swatches to set.

## Good image swatches

* Keep them small and square — they're rendered at swatch size, so a large file only slows the page down.
* Crop to the material itself rather than a whole product photo.
* Set the rendered size and whether the image fills or fits its chip under **Image** in [Customize a swatch style](/swatch/appearance/customize-a-swatch-style.md).

## Faster ways to fill the list

* [Fill swatches with AI color match](/swatch/options/ai-color-match.md) — the app proposes a colour for every value at once.
* [Import and export swatches by CSV](/swatch/options/import-and-export-swatches-by-csv.md) — best for long lists or moving settings between stores.

## Related pages

* [Choose a display style](/swatch/options/choose-a-display-style.md)
* [Sync product data](/swatch/getting-started/sync-product-data.md)
