Define a Shopify metaobject definition with typed fields via Admin GraphQL and create metaobject entries for structured content

In-depth guide

Steps

1. Use the metaobjectDefinitionCreate Admin GraphQL mutation to define a new metaobject type; specify type (a unique string like 'store_location'), name, and fieldDefinitions array with key, name, type (e.g., 'single_line_text_field', 'number_decimal', 'url', 'product_reference'), and validations if needed
2. Set capabilities.publishable.enabled: true in the definition if entries need to be published/unpublished independently (useful for CMS-style content); omit for always-visible data
3. Create entries with metaobjectCreate, passing type and fields array with key-value pairs; values are always strings — for reference types pass the GID of the referenced resource
4. Query metaobjects via the Storefront API using the metaobjects query with type and first arguments; use edges { node { fields { key value } } } to retrieve entries with their fields
5. To expose a metaobject field on a product page, add a product metafield (type 'metaobject_reference') pointing to a metaobject entry and query it via Storefront API product.metafield(namespace, key) { reference { ... on Metaobject { fields { key value } } } }
6. Update entries with metaobjectUpdate passing the metaobject GID and updated fields; delete with metaobjectDelete