Variant metafields not accessible from editor

Technical Q&A

Topic summary

Main issue: Variant-level metafields (custom fields attached to individual product variants) cannot be selected from the Theme Editor’s dynamic source menu, and manually entering the reference returns “custom metafield is invalid.”

Context: The user created a variant metafield, assigned a value to a specific product variant, then tried to surface it in the product template. The dynamic content picker does not list the variant metafield, and manual input fails validation.

Evidence: Screenshots show the metafield configuration, the attempt to type the variant metafield reference, and the error message in the editor. Images are central to seeing the exact error and UI steps.

Status: No solution or workaround provided yet. The user seeks guidance on how to display variant-specific content on the storefront via the editor.

Open questions: Whether variant metafields are accessible in product templates via dynamic sources, required liquid objects/sections, or alternative implementation steps.

Summarized with AI on January 10. AI used: gpt-5.
1

I’ve created a metafield for variants:

Screenshot 2023-12-19 at 11.40.59 am.png
Screenshot 2023-12-19 at 11.40.59 am.png1494×2068 198 KB

I’ve then, in a product, within a variant, set a value on this to see it working on the front end. After this I went to the product template and tried to add it into the content (I can’t find it in the dynamic content menu):

Typing the variant product in as I can't get it within the dynamic source menu
Typing the variant product in as I can't get it within the dynamic source menu580×454 12.5 KB

showing the error saying the custom metafield is invalid
showing the error saying the custom metafield is invalid670×680 38.1 KB

The first image shows me typing the variant as I can’t get it through the dynamic source menu. The second image shows the error message.

How can I add these details onto my site? It doesn’t feel like it should be this hard to use variant content.