ST-2026-052 · Authentication & identity
Shopify Customer Account API requires app-metafield definitions
App-resource metafields without definitions and Customer Account API permissions no longer return values through customer-account surfaces.
ShopifyCustomer Account APImetafieldspermissions
Previous state
App-resource metafields could be read without the newly required definition and customer-account access configuration.
Current state
Apps must create metafield definitions and grant Customer Account API access for customer-account UI, Hydrogen and headless use.
Affected users
Who needs to care
Apps exposing app-owned metafields through Shopify customer accounts.
Required response
What to do
Create definitions, configure access and test each customer-account integration.
Evidence boundary
What the source does not prove
Customer- and Order-owned metafields are explicitly outside this change.
Lifecycle history
Dated event sequence
- Enforcement effective
Undefined app-resource metafields stopped returning through the Customer Account API.
Evidence ledger
First-party sources
- 01Shopify Developer Changelog — Metafields now require a definition to be accessed through the Customer Account API
Official developer changelog · 2026-06-16
Open official source ↗