Agent skill · marketing growth · jeremylongshore
shopify-metafields-metaobjects
Model custom data with Shopify metafields and metaobjects via the GraphQL
Why this skill is useful
Provides specific GraphQL commands and patterns for managing Shopify metafields and metaobjects that the AI wouldn't reliably generate on its own.
What it needs
Requires shopify account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify Metafields & Metaobjects Overview Metafields attach key-value custom data to existing resources (products, variants, orders, customers). Metaobjects define entirely new content types with custom schemas. Together they replace the need for external databases for most custom data needs. Prerequisites Completed shopify-install-auth setup Access scopes: readmetaobjects, writemetaobjects, readmetaobjectdefinitions, writemetaobjectdefinitions Metafield scopes per resource: readproducts/writeproducts for product metafields, etc. Instructions Step 1: Define a Metafield on Products Use metafieldDefinitionCreate with namespace, key, type, and ownerType: Step 2: Set Values in Batch with metafieldsSet Step 3: Create a Metaobject Definition Define a custom content type (e.g., "Designer" with typed fields): Step 4: Create Metaobject Instances See metafield-types.md for all types, toml-config.md for app config, and bulk-metafield-ops.md for bulk operations. Output Metafield definitions registered on target resource types Metafield values set on individual resources (batch supported, max 25 per call) Custom metaobject types with typed field schemas Metaobject instances queryable via Storefront and Admin APIs Error Handling Error Cause Solution ------- ------- ---------- TAKEN Namespace + key already exists on this owner type Use metafieldDefinitionUpdate or choose a different key INVALIDTYPE Type string not in Shopify's registry Check metafield-types.md INVALIDVALUE Value doesn't match declared type Cast value to correct format before setting TOOLONG Value exceeds type limit (512KB for text types) Truncate or switch to multilinetextfield Examples Adding Care Instructions to All Products Define a "careinstructions" metafield on the PRODUCT owner type, then bulk-set values across hundreds of products in batches of 25. See Bulk Metafield Ops for the batch set/delete operations. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-metafields-metaobjects