🔍 Variant custom.color check
Each variant should show "custom.color = present". If you see "BLANK", enable Storefront API access for the
variant metafield custom.color in Settings → Custom data → Variants.
Variant 48058221133987 (American Walnut | Brown): custom.color =
present (handle: american_walnut)
Variant 48058221363363 (American Walnut | Brown): custom.color =
present (handle: american_walnut)
Variant 48058221396131 (American Walnut | Brown): custom.color =
present (handle: american_walnut)
Variant 48058221461667 (American Walnut | Brown): custom.color =
present (handle: american_walnut)
Variant 48058221428899 (American Walnut | Brown): custom.color =
present (handle: american_walnut)
Variant 48058221527203 (Castle Gate | Gray): custom.color =
present (handle: castle_gate)
Variant 48058221559971 (Castle Gate | Gray): custom.color =
present (handle: castle_gate)
Variant 48058221625507 (Castle Gate | Gray): custom.color =
present (handle: castle_gate)
Variant 48058221592739 (Castle Gate | Gray): custom.color =
present (handle: castle_gate)
Variant 48058221494435 (Castle Gate | Gray): custom.color =
present (handle: castle_gate)
Variant 48058221691043 (French White Oak | White): custom.color =
present (handle: french_white_oak)
Variant 48058221723811 (French White Oak | White): custom.color =
present (handle: french_white_oak)
Variant 48058221789347 (French White Oak | White): custom.color =
present (handle: french_white_oak)
Variant 48058221756579 (French White Oak | White): custom.color =
present (handle: french_white_oak)
Variant 48058221658275 (French White Oak | White): custom.color =
present (handle: french_white_oak)
🖼️ Current variant's color
Shows the swatch for the variant selected on load. Use ?variant=ID&debug=swatch to see a different
color (e.g. Bluestone variant ID).
Handle: american_walnut (variant 48058221133987)
Swatch:
//www.hartvillehardware.com/cdn/shop/files/2b40c4e5e925e84f985c0f9c...
🖼️ Direct test: Color metaobject handle "black" — variant_swatch_images
Fetches metaobjects.color.black and displays its Variant Swatch Images field. If you see the image
below, the theme can read it.
✅ metaobjects.color.black found (handle: black)
✅ Image found via: variant_swatch_images.value[0]
Image URL: //www.hartvillehardware.com/cdn/shop/files/2921c894ef981663f7e13ca96c9dc5236ad3e02e_black.jpg?v=1765429244&width=120
Rendered image:
Same image via variant (path used by swatches)
Uses variant.metafields.custom.color.value for a variant whose color handle is "black".
❌ No image via variant path (variant_swatch_images blank when read from
variant.metafields.custom.color.value)