Swatchfy shows shoppers only the photos that belong to the variant they selected, and turns your variant options into color or image swatches. Setup takes about five minutes.
Search for Swatchfy: Variant Image Swatch on the Shopify App Store, or open the listing directly.
Click Install, then confirm the permissions screen.
After installing you will land on the Swatchfy dashboard, which shows a setup checklist.
Swatchfy runs as a theme app extension, so it has to be switched on inside your theme before anything appears on the storefront.
From the dashboard, open the Variant image status card and click through to the theme editor.
In the theme editor, open App embeds in the left sidebar.
Turn on Swatchfy — Variant Images. If you also want swatches, turn on Swatchfy — Swatch.
Click Save in the theme editor.
Back in the app, use Check status to confirm the embed was detected.
You can reach the same place manually: Online Store › Themes › Customize › App embeds.
On the dashboard, find the product you want in the Configure new products table and click Assign images. You can also use the search box to find it faster.
The page shows one tab per option name (for example Color). Pick the tab you want to configure.
Each option value (Black, White, Coral…) has its own drop zone. Drag images from the media list onto the option value they belong to. You can drop as many images as you like on a single value.
Images you leave alone stay in Images not assigned to any option value at the bottom.
Click Save when you are done.
Useful buttons on this page:
Reset — clears the assignments for the option you are currently viewing.
Delete — removes the whole configuration for this product.
View on store — opens the product page so you can check the result.
Swatches are optional. Skip this step if you only want gallery filtering.
Open the Swatch page and turn Swatch status on.
In Option names, list the option names that should render as swatches, separated by commas — for example Color, Colour, Farbe. Options not on this list are left untouched.
Choose how each value looks:
+ Set swatches — assign a color or an image to the values of one specific product. Setting either a color or an image is enough; if you set both, the image wins.
Bulk set swatches — set a default color or image for an option value once and have it apply across your entire store. Product-level swatches always override these defaults.
Turn on Enable on product cards if you want swatches to appear on collection, search and other listing pages as well.
Click Swatch style to change how swatches look. You can style the product page and the product card separately.
Pick a preset as a starting point, then adjust shape, size, border width and selected-border color.
Under Advanced swatch settings you can automatically hide options whose variant is sold out or has been deleted.
If you need something the controls do not cover, use the Custom CSS box. Swatch elements use the kiteapps-swatch class.
Nothing is applied until you press Save.
Open the Settings page to control how the gallery behaves:
Variant images status — the master switch for gallery filtering on your storefront.
Hide unassigned images — when on, photos that are not assigned to any option value are hidden from the gallery. Turn it off if you want unassigned photos to always stay visible.
Allow assigning the same image to multiple options — turn this on when one photo legitimately belongs to more than one option value.
Press Save to apply.
If something is not working as expected, email [email protected] with your store URL and, if possible, a link to the product page in question. That helps us reproduce the issue quickly.
