Use a custom image for a value
Some values can't be shown with a flat colour: a leopard print, brushed metal, a denim wash. Give those values an image instead, and the swatch shows a close-up of the material.
Suitable for
Patterns, prints, textures, materials and finishes that look the same on every product with that value.

Prerequisites
The option uses Image swatch, which prefers the image. Color swatch, Variant image and Polaroid also show it, but only when they have no colour or variant photo to draw first.
Your image is a JPG or PNG up to 2 MB. A square image of at least 100 × 100 px works best.
Set an image
- 1
Open the option's values
In Options, click Edit on the option.
- 2
Choose the image
On the value's row, click Image to pick a file from your Shopify Files library. To send a new file from your computer, click Upload next to it.

The Image and Upload buttons on a value row - 3
Check the preview
The image appears on the row with a Selected · save to apply note. Large images are scaled down automatically so the swatch stays quick to load.
- 4
Save
Click Save in the save bar. You can set images on several values before saving.
Note
A value holds either a colour or an image, not both. Setting an image replaces the value's colour, and setting a colour replaces its image.
Custom image or variant photo?
| Use | When |
|---|---|
| Custom image | The same texture applies to every product with this value, for example every Leopard product uses the same print chip. |
| Variant photo | Each product's variant looks different and already has its own photo. See Use the variant's own photo. |
Remove an image
Click the small × next to the image preview on the value's row, then Save.
Troubleshooting
- The file is a JPG or PNG under 2 MB.
- You clicked Save after choosing the image.
- The option's style draws images, not Buttons or a plain Dropdown.
- The option's Swatch image isn't set to Variant photo, which uses the product photo instead.
If the Shopify file picker doesn't open, use Upload instead.
Need help?
Open the app and click Chat with us on the Dashboard for free setup assistance, or contact us with your store address and what you are stuck on.