Which Shopify themes are compatible with variant image apps?
Prolific users of variant images or swatch apps often ask a similar question before installing an alternate: Does it work with my current theme? Most variant or swatch style apps have compatible themes in mind when designing how to function. Some require special modifications to the code of your theme. Others are designed to function by inserting content within the theme, and as a general rule will work if any portion of the app is displaying correctly. It’s usually best to check reviews or ask for assistance before trying out an app to see if it will work.
This guide covers how variant image and swatch theme apps are compatible with themes, how to check compatibility before you install a theme, lists known theme issues, and answers questions about unsupported themes.
In this post
- Online Store 2.0 and theme app blocks
- How variant image apps integrate with themes
- Compatibility with popular themes
- How to check compatibility before installing
- Common theme-specific issues
- FAQ
Online Store 2.0 and theme app blocks
When Shopify Online Store 2.0 launched (2021) it introduced “app blocks” – a way for apps to insert content in certain areas of the store without having to modify the theme code. Shopify themes based on the 2.0 architecture support app blocks natively. Older Shopify themes (pre-2.0) do not.
With OS 2.0, Version 2.0 of variant image and swatch apps you can add swatch picker and image filtering on the product page via the theme customizer. No Liquid code required – just an app block and you’re good to go.
All free and paid themes in the Shopify Theme Store are now OS 2.0 compatible and support all new features and app blocks introduced after 2022. However, if you purchased and downloaded your theme before 2022 or are using a custom theme, it might not be compatible with new app blocks. To check, log in to your store and go to Customize and select the product page section. Look for “Add block” or “Add app” options.
How variant image apps integrate with themes
Two integration approaches:
- App blocks (OS 2.0). The app provides a block that you add through the theme customizer. It renders within the theme’s section structure. Clean, no code changes, survives theme updates. Most modern apps support this.
- Script injection. The app injects JavaScript that modifies the product page after it loads. Works with any theme (including pre-2.0) because it operates on the rendered page, not the theme code. The trade-off: slight delay on page load while the script runs, and potential conflicts with theme JavaScript.
Rubik Variant Images supports both methods of integration. On OS 2.0 themes it will use app blocks on the theme customizer, and on older themes it will use a little bit of script injection to keep it 100% compatible with 350+ Shopify themes that it’s been verified to work with.
Compatibility with popular themes
| Theme | OS 2.0 | RVI compatible | RCL compatible | Notes |
|---|---|---|---|---|
| Dawn | Yes | Yes | Yes | Shopify default. Full app block support. Dawn swatch guide |
| Prestige | Yes | Yes | Yes | Has native swatches. Disable native when using app. Prestige guide |
| Impulse | Yes | Yes | Yes | Feature-rich. Native swatches available |
| Horizon | Yes | Yes | Yes | Shopify premium. Multiple Horizon guides available |
| Broadcast | Yes | Yes | Yes | Default swatches small (28px) |
| Sense | Yes | Yes | Yes | Clean layout, editorial focus |
| Craft | Yes | Yes | Yes | Compact design, small catalogs |
| Spotlight | Yes | Yes | Yes | Modern, content-focused |
| Palo Alto | Yes | Yes | Yes | Premium, clean aesthetic |
| Impact | Yes | Yes | Yes | Bold, conversion-focused |
This is a partial list. Rubik Variant Images has been tested with 350+ themes. If your theme is not listed, it is still very likely compatible. Install the free plan and test on your store before upgrading.
How to check compatibility before installing
- Check if your theme is OS 2.0. Go to Customize, navigate to a product page, and look for “Add block” or “Add app” in the left panel. If these options exist, your theme supports app blocks.
- Check the app’s compatibility list. Most swatch and variant image apps list supported themes on their App Store listing or documentation site. Rubik Variant Images supported themes lists all verified themes.
- Install the free plan and test. Most apps offer a free plan or trial. Install it, enable it on one product, and check the product page. If swatches render correctly and image filtering works, you are compatible.
- Contact app support. If you have a custom or uncommon theme, contact the app’s support team before installing. They can check compatibility and often add support for new themes on request.
Common theme-specific issues
- Duplicate swatch pickers. Theme has native swatches + app adds its own swatches = two swatch rows. Fix: disable the theme’s native swatches in theme settings before enabling the app. See our swatch conflict guide.
- Gallery not updating on variant change. Some themes use custom JavaScript for the gallery that does not fire standard Shopify variant change events. The app cannot detect the variant switch. Fix: contact app support. Most apps can add theme-specific event listeners.
- Swatches render in wrong position. The app block appears above or below where you want it. Fix: drag the app block to the correct position in the theme customizer. Most OS 2.0 themes let you reorder blocks within a section.
- Sticky header overlaps swatches on mobile. Some themes have a sticky header that covers the top of the product page on scroll. Swatches can get hidden behind it. Fix: add CSS padding-top to the product section or reduce the sticky header height.
For page builder themes (GemPages, PageFly, EComposer, Foxify, Instant, Beae, Replo), both Rubik Variant Images and Rubik Combined Listings are compatible. Page builders create their own product templates but the apps inject at the theme level, so they work regardless of which page builder you use.
“This App and support crew are AMAZING! I spent hours trying to find a way to easily assign variant images for my products and thankfully I finally found Rubik Variant Images! I have reached out to the support team a few times when trying to get my custom theme working with the app and they responded within seconds to assist and had me up and running in no time! Definitely recommend!”
Stunnify, US, Rubik Variant Images on the Shopify App Store
Frequently asked questions
Do variant image apps work with all Shopify themes?
Most modern apps currently support OS 2.0 themes (all created since 2022) and also apps using script injection for older theme support. Rubik Variant Images currently supports 350+ different themes, including both app block and injected versions.
What if my custom theme is not supported?
This is where you have to ask the app developers for new themes to be supported. The creators of most apps will add themes to the app for you if you ask nicely. The creators of the Rubik Variant Images app state that you can have support for new themes within 24 hours.
Do variant image apps work with page builders?
Yes. These features for Rubik Variant Images and Rubik Combined Listings are supported for all 7 major page builders: Beae, EComposer, Foxify, GemPages, Instant (with restrictions), PageFly (with restrictions) & Replo. However Shogun is not supported.
Will a theme update break the app?
Most apps using app blocks should survive theme updates since the block is separate from the theme code. Some apps that use script injection to insert data may break depending on the HTML changes in the theme. Most app developers are very responsive and issue updates within a day or two of the big theme release.
Should I disable my theme’s native swatches when using a swatch app?
Duplicate pickers, conflicts. Turn off native swatches in theme settings and let app generate swatches.
