We have our Wishlist Page embedded in the Customer Accounts section of our Shopify store. The page loads with an error, and after investigating, we’ve traced the issue to Shop Metafields returning blank/null values when queried through the Customer Accounts API.
What we’re seeing:
The Wishlist Page renders but immediately throws an error
Querying Shop Metafields via the Customer Accounts API returns empty values
The same metafields return correctly when queried via the Admin API
API versions we’ve tried:
shopify:customer-account/api/2026-01/graphql.json
shopify:customer-account/api/2024-10/graphql.json
The metafields exist and have values – we can confirm this via the Admin API. The issue appears to be specific to the Customer Accounts API context.
Has anyone run into this? Is querying Shop Metafields from the Customer Accounts API supported, or does it require a different approach?
This is a known issue that other developers have run into recently — Shop metafields now require a metafield definition to be accessible via the Customer Accounts API (and the Storefront API). Unnamed/definition-less metafields will return null on those surfaces, even though they still work fine through the Admin API.
The fix is to create a metafield definition for each Shop metafield your Wishlist extension needs to read. You can do this via the Admin GraphQL API using the metafieldDefinitionCreate mutation, or through the Shopify Admin under Settings > Custom data > Shop.
Once the definitions are in place, the Customer Accounts API should start returning the values as expected.
@stephen-shopify Was this change publicly announced or documented somewhere that you can reference? It caught us totally off guard last week – it was not fun to push out hotfixes to prod before a holiday weekend