Shopify Impulse theme variant images work differently from most themes. Impulse uses an alt-text method to group product images by variant. You add a hashtag to each image’s alt text (like #color_blue), and the theme filters the gallery based on which variant is selected.
It works. But it is tedious, fragile, and does not scale. One typo breaks the grouping. One missing hashtag and the image disappears. If you have 50 products with 8 colors each, that is hundreds of alt-text fields to edit manually.
There is a better way. Rubik Variant Images handles variant image grouping with a visual drag-and-drop interface. No alt text editing. No hashtags. And it works with Impulse and 350+ other themes.
In this post
- How Impulse handles variant images (the alt-text method)
- 5 problems with the alt-text method
- The better way: Rubik Variant Images on Impulse
- How to set it up (5 minutes)
- What you get vs the alt-text method
- Frequently asked questions
- Related reading
How Impulse handles variant images (the alt-text method)
Impulse (by Archetype Themes, theme ID: 857) introduced “variant image sets” in version 3.6.0. The idea: use the alt text field on each product image to assign it to a variant.
Here is how it works:
- Open a product in Shopify admin.
- Click on each image and edit its alt text.
- Add a
#followed by the variant option value. For example:Front view of burnt orange sweater #Burnt Orange - Everything before the
#is the actual alt text (shown to screen readers). Everything after the#is used by the theme to group the image into a variant set. - Repeat for every image on every product.
When a customer selects “Burnt Orange,” the theme hides all images that do not have #Burnt Orange in their alt text and shows only the matching ones.
There is a catch: when image sets are used, all images must belong to a set. Any image without the hashtag in its alt text will not show at all. Miss one image and it vanishes from the gallery.
5 problems with the alt-text method
1. One typo breaks everything
The hashtag must match the variant option value exactly. #Burnt Orange is not the same as #burnt orange or #BurntOrange or #Burnt orange. One wrong capital letter, one extra space, and the image either disappears or shows up for the wrong variant.
2. It does not scale
A product with 6 colors and 5 photos per color has 30 images. Each one needs its alt text edited manually. Now multiply that by 100 products. That is 3,000 alt-text fields to edit. There is no bulk editor for this.
3. It mixes SEO alt text with functional data
Alt text exists for accessibility and SEO. Screen readers read it aloud. Google uses it to understand image content. Stuffing functional hashtags into the alt text pollutes both. Your image alt text becomes “Blue cotton t-shirt front view #Blue” instead of a clean “Blue cotton t-shirt, front view on white background.”
4. Forgotten images disappear
If you add a new image to a product and forget to add the hashtag, the image is invisible on the storefront. It is in Shopify admin but not shown to customers. This is confusing and easy to miss.
5. It only works on Impulse
If you switch themes, all your alt-text work is wasted. The hashtag syntax is specific to Impulse (and a few other Archetype themes like Streamline, Broadcast, and Expanse). Move to Dawn, Horizon, or any other theme and the image sets stop working entirely.
The better way: Rubik Variant Images on Impulse
Rubik Variant Images & Swatch includes dedicated native code for the Impulse theme (ID: 857). You assign images to variants with a visual drag-and-drop interface. No alt text editing. No hashtags. No typo risk.
The app also replaces the default Impulse variant picker with visual swatches: image thumbnails, color circles, or pill buttons. Customers see what each variant looks like before clicking.
Here is what Rubik gives you on Impulse that the alt-text method does not:
- Drag-and-drop image assignment. Select images and drop them onto variants. Visual, fast, no typing.
- AI auto-assign. The app analyzes your product photos and matches them to variants automatically. 50 products with 8 colors? Run AI once and it is done in minutes.
- Unlimited images per variant. Assign 3, 6, or 20 images per variant. No limit.
- Videos and 3D models per variant. Not just static photos. The alt-text method only works with images.
- Visual swatches. Replace Impulse’s dropdown or button picker with image thumbnails, color circles, or pill buttons. 100+ CSS variables for full styling control.
- Shadow DOM isolation. Swatch styles cannot conflict with Impulse’s CSS. No broken layouts.
- Works if you switch themes. Your image assignments are stored in Shopify metafields, not in alt text. Move from Impulse to Dawn, Horizon, Prestige, or any of the 350+ supported themes, and everything keeps working.
- Clean alt text for SEO. Your image alt text stays focused on accessibility and search engine optimization. No hashtags polluting it.
- Fastest loading. All data stored in Shopify metafields. No external API calls. Swatches load with the page.
How to set it up (5 minutes)
- Install Rubik Variant Images from the Shopify App Store. Free plan available.
- The app auto-detects that you are using the Impulse theme. If not, select “Impulse” as your theme type in the app settings.
- Open a product and drag images onto the variants you want them assigned to. Or click the AI auto-assign button and let the app figure it out.
- Enable swatches in the app settings. Pick your swatch type: image, color, or pill.
- Save. Visit your product page. Done.
The video tutorial shows the full process. The getting started guide covers each step with screenshots.
What you get vs the alt-text method
| Impulse alt-text method | Rubik Variant Images | |
|---|---|---|
| Setup method | Edit alt text on every image manually | Drag-and-drop or AI auto-assign |
| Time per product (8 colors, 5 photos each) | 10-15 minutes | Under 1 minute (with AI) |
| Typo risk | High (exact match required) | None (visual interface) |
| Images per variant | Unlimited (with correct alt text) | Unlimited (drag-and-drop) |
| Video per variant | No | Yes |
| 3D models per variant | No | Yes |
| Visual swatches | No (uses Impulse’s native picker) | Image, color, pill, dropdown |
| Swatch customization | Limited to Impulse’s options | 100+ CSS variables, Shadow DOM |
| Works on other themes | Only Archetype themes | 350+ themes + 7 page builders |
| Alt text stays clean for SEO | No (polluted with hashtags) | Yes |
| Bulk setup | No | Yes (AI bulk assign) |
| Accessibility | Depends on theme | ARIA labels, keyboard nav, screen reader |
| Price | Free (built into theme) | Free plan (1 product), $25/mo for 100 |
Frequently asked questions
How do variant images work in Shopify Impulse theme?
Impulse uses an alt-text method. You add a hashtag followed by the variant option value (like #Blue) to each image’s alt text. The theme hides images that do not match the selected variant. All images must have a hashtag assigned, or they will not show. This feature was introduced in Impulse version 3.6.0.
Can I show multiple images per variant on Impulse without editing alt text?
Yes. Rubik Variant Images handles variant image grouping through a drag-and-drop interface. No alt text editing needed. The app has native code specifically for the Impulse theme (ID: 857) so it detects variant changes and updates the gallery automatically.
Can I add image swatches to Impulse theme?
Impulse has built-in color swatches that require uploading .png files to your Shopify Files (Content > Files) with specific naming like heather-grey.png. Rubik Variant Images replaces this with automatic image swatches that use your actual product photos as thumbnails. No file uploads, no naming conventions.
Does this work with other Archetype themes like Streamline and Broadcast?
Yes. Rubik Variant Images includes native code for Impulse (ID: 857), Streamline (ID: 872), Broadcast (ID: 868), Cascade (ID: 859), Expanse (ID: 902), Motion (ID: 847), Split (ID: 842), and other Archetype themes. The same drag-and-drop setup works on all of them. See the full theme list.
What happens if I switch from Impulse to another theme?
If you used the alt-text method, your image groupings stop working on the new theme. If you used Rubik Variant Images, everything keeps working. Image assignments are stored in Shopify metafields, not in alt text. Switch to Dawn (ID: 887), Horizon (ID: 2481), Prestige (ID: 855), Focal (ID: 714), or any other theme, and the app detects it and adapts automatically.
Can AI assign all my images to variants automatically?
Yes. Rubik’s AI auto-assign analyzes your product photos and matches them to the correct variants. You can run it on one product or across your entire catalog with bulk assign. No other variant image app on Shopify offers this. Read more in the FAQ.
Try it on the demo store, or read the documentation.
Related reading
- How to show different images for each color variant on Shopify
- How Shopify variant images really work
- Shopify variant images not showing? 10 causes and how to fix (Rubik Variant Images)
- How to add variant image swatches in Shopify Prestige theme (Rubik Variant Images)
- Shopify color swatches not working: troubleshooting guide (Rubikify)
