Using Shopify Sidekick with variant images

Shopify Sidekick variant images is one of those searches where the answer is half yes and half no, and the half nobody tells you about is the half that actually breaks the product page. Sidekick can upload images in bulk, write alt text, rename files, and even draft a new product description around a gallery. What it cannot do is the thing most merchants open it for: assign the right image to the right variant so the gallery filters when a shopper clicks a swatch.

This post walks through exactly where Sidekick helps on the image workflow, exactly where it taps out, and the clean handoff to Rubik Variant Images for the variant-level work. If you have been trying to get Sidekick to “just show the red shirt when someone picks red” and running in circles, the split below will save you an afternoon.

Rubik Variant Images is a product page only app. Everything here is scoped to what shoppers see after clicking into a product. Collection page swatches are a different problem handled by Rubik Combined Listings on rubikify.com.

In this post

• What Sidekick can do with product images
• What Sidekick cannot do with variant images
• Why the gap exists
• Where Rubik Variant Images fits
• A combined workflow that actually works
• Example Sidekick prompts for image tasks
• Troubleshooting the handoff
• FAQ

What Sidekick can do with product images

Sidekick is the free AI assistant inside the Shopify admin. It runs on Shopify Magic and it can touch a surprising amount of the product image workflow. The short list:

• Upload images to a product you are viewing or to a product you name in the prompt.
• Write or rewrite alt text for every image on a product.
• Generate file names from product titles and variant names.
• Remove image backgrounds using the built-in Shopify Magic editor.
• Reorder the product gallery based on a description (“put the lifestyle shots first”).
• Suggest missing images (“this product has red and blue variants but only red photos”).
• Draft product descriptions that reference the gallery.

Any of these can be done with a single prompt in the Sidekick panel. If you have never tried it, start with “write alt text for every image on the product I am viewing, focusing on color and material.” It takes about ten seconds and produces alt text that is better than 90% of the alt text merchants write by hand.

For a broader tour of what Sidekick is and how it works, we wrote a Shopify Sidekick guide on craftshift.com that covers the full feature set and the security model.

What Sidekick cannot do with variant images

Here is the hard wall. Sidekick cannot assign specific images to specific variants. It cannot say “this image belongs to the red variant, filter it when red is selected.” It cannot create the variant-image relationship that the Shopify product page needs to filter the gallery when a shopper clicks a color.

Ask Sidekick to “show only the red images when the red variant is selected” and you will get a polite non-answer that either suggests you use the variant image selector in the admin (which only assigns one image per variant, not a set) or points you at a third-party app.

The reason this matters is that the Shopify native variant image feature only holds a single “featured” image per variant. Most real product catalogs need several images per variant: a front shot, a back shot, a lifestyle photo, a detail shot. Sidekick inherits the same limitation. It cannot bypass the Shopify data model.

If you want to verify your current setup, we have a free variant image setup checker that reads your product and reports how many images are actually wired to each variant. Most stores find the number is smaller than they expected.

Why the gap exists

Shopify’s native variant image field is one image per variant. Period. That field has been in the platform since day one and a lot of infrastructure depends on it. When Sidekick talks to the admin API, that is the only lever it has for variant-level assignment.

Multiple images per variant has to live somewhere else, and on Shopify that somewhere is a metafield on the variant or the product. Rubik Variant Images stores the assignment in a metafield, reads it in the theme, and filters the product gallery on the fly when a shopper clicks a swatch. No external API calls, no server round-trip. It loads with the page itself.

Sidekick does not write to that metafield. It has no awareness of it, because the metafield is defined by Rubik, not by Shopify core. Even if Sidekick were trained on Rubik’s data model, the safe design choice for Shopify is to keep AI actions scoped to native fields until merchants explicitly opt in.

The practical outcome is that Sidekick handles the image asset layer (upload, alt text, naming, cleanup) and Rubik Variant Images handles the variant assignment layer (which image belongs to which option, how the gallery filters). Both layers are needed. Neither replaces the other.

Where Rubik Variant Images fits

Rubik Variant Images is scoped to one job: make the product page gallery show the right images when a shopper picks a variant. That sounds narrow because it is narrow. Narrow is why it works.

Three assignment methods cover every catalog type:

1. Manual assign. Pick images per variant inside the app UI. Fast for small catalogs or one-off fixes.
2. AI auto-assign. Per-product. Reads the product name, variant name, image filename, and image alt text, then proposes a mapping. One product at a time. Best for stores where file names and alt text are already clean, which is exactly what Sidekick is good at producing. See the AI auto-assign walkthrough for the full flow.
3. Bulk assign. Image-order based grouping. Reads the Shopify gallery order and detects featured image boundaries, then groups the images between boundaries as belonging to one variant. Runs in the background across hundreds of products. No AI, no filename matching. See the bulk assign guide for the pattern.

Once the assignment is written, the product page gallery filters automatically whenever a shopper clicks a swatch or changes a variant through the native selector. The swatches themselves are also rendered by Rubik, with configurable shapes and sizes, so you get a consistent look across every product. For a wider walkthrough of how many images per variant actually helps conversion, we have a dedicated post.

A combined workflow that actually works

Here is the flow we recommend when Sidekick is already in your toolkit:

1. Bulk upload the raw gallery with Sidekick. Use a prompt like “upload these twelve images to product Anvil Tee and add them to the gallery.” Repeat for each product, or use one of the Craftshift bulk image tools for larger batches. Sidekick is fine for a dozen products at a time.
2. Clean filenames and alt text with Sidekick. “Rewrite every image filename on this product to include the variant color, and write alt text that describes color, angle, and material.” This is the step that makes AI auto-assign in Rubik much more accurate later.
3. Open Rubik Variant Images and run AI auto-assign per product. Because Sidekick just cleaned the metadata, Rubik’s AI has the four signals it needs. Accept or tweak the mapping.
4. For larger catalogs, switch to bulk assign. Reorder the gallery so images for the same variant are grouped together, set the featured image per variant as the boundary, and run bulk assign. Hundreds of products in one background job.
5. Verify on the live product page. Click each swatch. Confirm the gallery filters cleanly. For extra confidence, run a variant image setup check on a few products at random.

This flow uses each tool for what it is best at. Sidekick handles the asset and metadata work. Rubik handles the variant assignment and the front-end filtering. You never fight either one against the grain of its design.

If your store also groups colors as separate products (one product per color, not one product with color variants), the collection page side of that story is handled by Rubik Combined Listings on rubikify.com.

Example Sidekick prompts for image tasks

These all work in Sidekick today and feed cleanly into a Rubik Variant Images workflow.

• “Write alt text for every image on the product Anvil Tee, focusing on color, material, and angle.”
• “Rename every image on the product I am viewing to include the variant color.”
• “Reorder the gallery so the red images come first, then blue, then black.”
• “Remove the background from image 3 on the product I am viewing.”
• “Which products in my catalog have variants without any images assigned?”
• “Upload these photos to the product named Denim Jacket and add them to the gallery.”
• “Draft a product description for this product that references the three main gallery shots.”

The last one sounds like a writing task but it is actually a data hygiene task. A description that mentions the gallery cues Rubik’s AI auto-assign to pick up on the variant-color connection.

Troubleshooting the handoff

A few things go wrong at the handoff between Sidekick and Rubik. All of them are fixable in under a minute.

• Gallery order is wrong. Bulk assign reads gallery order. If Sidekick reordered the gallery and broke the variant boundaries, reorder once more or switch to AI auto-assign.
• Alt text is generic. If every image has the same alt text, AI auto-assign has no signal. Ask Sidekick to rewrite alt text per image with color and angle.
• Filenames are timestamps. If your files are named IMG_0001 through IMG_0120, Sidekick can rename them in bulk. Run that before AI auto-assign.
• Variants are missing featured images. Shopify’s native field still matters for the featured thumbnail. Set one per variant manually, then let Rubik fill out the rest.
• Swatches do not appear. Check that the Rubik swatch block is enabled in your theme customizer. The theme compatibility list covers 300+ themes verified and supported.

FAQ

Can Shopify Sidekick assign images to product variants?

No. Sidekick can upload, rename, and reorder images, but it cannot assign specific images to specific variants. Use a dedicated variant image app for that.

Does Sidekick work with Rubik Variant Images?

Yes, as complementary tools. Sidekick handles asset upload, alt text, and filenames. Rubik handles the variant assignment and the product page gallery filtering.

Will Sidekick overwrite Rubik’s variant image assignments?

No. Rubik stores assignments in metafields that Sidekick does not touch. Sidekick edits to the gallery (reorder, rename) can affect bulk assign boundaries, so review the Rubik assignment after any big Sidekick edit.

Can Sidekick generate product images from scratch?

Shopify Magic can edit existing images (background removal, color swap, basic adjustments) but it does not generate wholly new product photos from a prompt.

Is Rubik Variant Images faster than Shopify’s native variant images?

Both are metafield-based and load with the page itself. Rubik adds the ability to assign multiple images per variant, which native Shopify does not support.

How many images can each variant have in Rubik?

As many as you need, within Shopify’s limit of 250 images per product. Rubik does not impose a per-variant cap.

Do I need both Sidekick and Rubik?

Sidekick is free on every Shopify plan so there is no reason not to use it. Rubik is needed whenever you want more than one image per variant filtered on the product page.

Related reading

• Check your variant image setup on Shopify
• How Rubik AI auto-assigns variant images
• Rubik bulk assign variant images
• What is Shopify Sidekick and how to use it
• Using Shopify Sidekick for combined listings

Next step: clean your image metadata with Sidekick, then open Rubik Variant Images and run AI auto-assign on your top ten products.