skills.rest
tomtoto757
tomtoto757COMMUNITY
Explore all skills by this author →
GitHub

shopify-metafields

Create typed Shopify metafield definitions and metaobjects accessible from Liquid and the Storefront API.

3|1|Updated Mar 21, 2026
Search Tags:#GraphQL#Shopify#liquid#metafields#Storefront API#custom data#metaobjects
One-click install
npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill shopify-metafields-tomtoto757
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shopify-metafields
Source: https://github.com/tomtoto757/ecomm-ai-team/tree/main/skills/platform-integrations-infrastructure/finsilabs/platform-shopify/shopify-metafields
Command: npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill shopify-metafields-tomtoto757

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shopify's default resource fields cannot hold custom data like care instructions, dimensions, loyalty tiers, or FAQs, forcing developers to misuse product descriptions or build external databases. This Skill provides the exact Admin API, Storefront API, and Liquid patterns for storing structured custom data on any Shopify resource with type validation. ## Core Features & Use Cases - Metafield Definitions: Create typed definitions (text, number, date, URL, JSON, file, product reference, and more) via the Admin API with storefront visibility controls. - Bulk Metafield Writes: Set metafields across many resources using the metafieldsSet mutation with 25-per-request batching. - Metaobjects: Build reusable structured content entries (FAQs, testimonials, specs) that non-technical staff can edit in the Shopify Admin UI. - Use Case: An outdoor retailer needs weight and dimension data on 150 products for EU compliance. Use this Skill to create the definitions, bulk-populate values in batches, and render the data in Liquid and a headless storefront. ## Quick Start Ask the AI to create a Shopify metafield definition for product care instructions and show how to read it in a Liquid template and via the Storefront API.

Frequently Asked Questions about shopify-metafields

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add custom fields to Shopify products?▼

Create a metafield definition with the metafieldDefinitionCreate Admin API mutation, specifying a namespace, key, type, and ownerType of PRODUCT. Then write values with metafieldsSet and read them in Liquid via product.metafields.namespace.key.

What is the difference between Shopify metafields and metaobjects?▼

Metafields attach single typed values to existing resources like products or orders. Metaobjects are standalone structured entries with multiple fields, ideal for reusable content like FAQs or testimonials that merchants edit in the Admin UI.

Why does my Shopify metafield return null in the Storefront API?▼

The metafield definition must have visibleToStorefrontApi set to true, since metafields are private by default. Update the definition with this flag, then query the metafield explicitly by namespace and key.

How do I bulk update Shopify metafields without hitting rate limits?▼

Use the metafieldsSet mutation, which accepts up to 25 metafields per call, instead of individual productUpdate mutations. Chunk your payload into batches of 25 and serialize all values as strings matching the metafield type.

Why is my list metafield a JSON string instead of an array in Liquid?▼

List-type metafields return raw JSON unless accessed correctly. Use the .value property in Liquid or the parse_json filter to iterate over list items, and use references(first: N) in the Storefront API for reference lists.

Related Skills

Explore More Software Engineering Skills→
JamesFincherJamesFincher

shopify

Manage Shopify products, orders, customers, inventory, and metafields via GraphQL with curl.

Community
Intermediate
EstomEstom

shopify-expert

Scaffold Shopify themes, headless storefronts, apps, and checkout extensions.

Community
Advanced
finsilabsfinsilabs
44

shopify-metafields

Store custom data on Shopify resources using metafield definitions and Metaobjects.

Official
Intermediate
finsilabsfinsilabs
44

product-information-management

Integrate PIM systems like Akeneo and Salsify to syndicate product data to e-commerce platforms.

Official
Intermediate