Public Radar/Shopify/Shopify: Breaking Change / Deprecation Notice
URGENT BREAKINGShopify

Shopify: Breaking Change / Deprecation Notice

Starting today, metafields stored on the app resource must have a metafield definition and customer accounts permissions to be accessible through the Customer Account API. Going forward, when calling the Customer Accounts API, app metafields without a definition will no longer return a value. If your app has functionality which depends on these fields, update those metafields to use definitions with the Customer Account API permission to avoid disruption. Action required: You must ensure that every metafield your app uses for customer account UI extensions, a Hydrogen or a Headless store, has a definition. • Run the metafieldDefinitionCreate for every store that installs your app to ensure the metafields are correctly defined. • For app-owned metafields, configure declarative metafields in your app’s TOML file. • Configure the access settings on your definition to allow customer accounts API access. Metafields owned by Customer or Order resources will not be affected by this change.
What to test in your app:
Review Shopify breaking change release notes for 'Metafields now require a definition to be accessed through the Customer Account API' and verify affected API integrations.
Method
Changelog
Freshness
Released: 2026-06-16 16:00 UTC
Deprecast API Radar

Track Shopify breaking changes automatically

Get urgent break alerts and weekly digests delivered straight to your email or Slack workspace before changes hit production.