Define Shopify metaobject definitions and create metaobject entries via Admin GraphQL to power structured content (e.g., store locator data)

In-depth guide

Steps

1. Call metaobjectDefinitionCreate mutation with a type handle, name, and fieldDefinitions array — each field has key, type (e.g., single_line_text_field, number_integer, file_reference), and validations
2. Set capabilities.publishable.enabled to true on the definition if entries need to be published/unpublished independently
3. Create entries with metaobjectCreate, passing the definition's type handle and fields array of {key, value} pairs; file_reference fields take a GID of a previously uploaded File
4. Query entries with the metaobjects connection, filtering by type; use the edges.node.fields to read back typed values
5. Reference metaobject entries from products or other resources by writing a metafield of type metaobject_reference pointing to the entry GID