shopify-metafields

To add custom fields to Shopify products and expose them, create typed metafield definitions using metafieldDefinitionCreate and mark them visibleToStorefrontApi. This enforces data types and allows Liquid themes and headless storefront queries to access the values.

The maximum batch size for writing Shopify metafields with metafieldsSet is 25 items per call. You must serialize numeric values as strings within these batches to ensure typed definitions validate and store the custom data correctly.

Use Shopify metaobjects instead of standard metafield definitions when you need multi-field structured content like FAQs or testimonials. You create metaobjectDefinitionCreate entries to manage these structured records, which can then be edited directly within the Shopify Admin UI.

Yes, you can attach typed custom data to Shopify orders and customers. This Skill supports applying typed metafield definitions across products, variants, orders, customers, collections, and pages for admin-managed content workflows.

Numeric metafield values fail validation during bulk writes if they are not serialized as strings. The metafieldsSet mutation requires numeric values to be passed as strings to successfully write data to the typed metafield definitions in batches of 25.

To render Shopify metafields in a headless storefront, explicitly request the namespace and key in your Storefront API query. You must first ensure the metafield definitions are created with visibleToStorefrontApi enabled for external access.