Customer Account API stops returning app metafields without definitions
Customer Account API no longer returns app-resource metafield values unless those metafields have definitions and customer-account access permissions.
Read the official Shopify source01 · Source fact
What changed
Customer Account API no longer returns app-resource metafield values unless those metafields have definitions and customer-account access permissions.
- Published
- Jun 16, 2026
- Effective
- 2026-06-16
- Deadline
- 2026-06-16
02 · Business impact
Who and what may be affected
- Operators
- Seller, Agency
- Surfaces
- Customer Account Api, Customer Account Ui, Headless Storefronts
- Impact
- Operations, Compliance
- Settlement categories
- No direct payout category identified
03 · Next action
What to check
Create or declare definitions for every app metafield used by customer-account extensions or headless storefronts and explicitly grant Customer Account API access.
confirmed source relationshipLast reviewed Jul 13, 2026