Variants buttons Dont work - No Image

Topic summary

Variant swatch buttons (clickable color previews) display without images on a custom/uploaded Shopify theme; size selection works. Screenshots show “no image” placeholders for color swatches.

Guidance: In many older themes, swatch images must be provided manually. Add image files to the theme’s assets, the Files admin, or as metafields, with filenames exactly matching the color option names. A common convention is 512×512 solid-color images. Implementation details vary by theme.

For newer setups, consider using Shopify category metafields (documentation link provided) to manage swatch images/values.

Suggested actions:

  • Verify whether the theme expects swatch images in assets, Files, or metafields, and upload matching files.
  • Ensure filenames exactly match color names used in product options.
  • Use recommended square images (e.g., 512×512) and solid color fills if appropriate.
  • If unsure, review theme code/settings or engage a developer for theme-specific adjustments.

Status: No confirmation of a fix yet; discussion remains open without a final resolution. Images are central to illustrating the issue.

Summarized with AI on December 17. AI used: gpt-5.

Hello,

I’m using an uploaded theme. It’s pretty cool and works great, but I realized it’s not optimized for variants. The variant buttons show without images, though everything works fine for product sizes.

Is this an easy fix, or do I need to change the code?

variants.jpg

variants2.jpg

For swatches in older themes , when there is a no image loaded icon in the browser , that means you need to make sure those images for those colors exist in the themes assets folder, or the files admin, or as metafields.

With the filename being the exact color name used in the options.

Typically 512px x 512px of solid color for the images content.

It varies widly among themes.

For newer category metafields see https://help.shopify.com/en/manual/custom-data/metafields/category-metafields/using-category-metafields

If you need theme repair or exploration services then contact me for services
Contact info in forum signature.
ALWAYS please provide context, examples: store url, theme name, post url(s) , or any further detail in ALL correspondence.