Return policy profiles are now available in the GraphQL Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on October 01, 2026.
This Shopify update is categorized as API, New, GraphQL Admin API, 2026-10.
What changed
API version 2026-10 adds return policy profiles to the GraphQL Admin API. A return policy profile is a set of return rules that you associate with markets, and it supersedes a store’s return policy text. Your app can now query each market's return rules as structured data, such as the length of the return window. What's added Two query fields: returnPolicyProfile: Returns a single profile by ID. returnPolicyProfiles: Returns a store's profiles.
Who is affected
Apps using the affected Shopify GraphQL API surface should review this change.
What action may be needed
You don't need to change your app. Existing queries that read policy text keep working. If your app reads return terms from REFUND_POLICY in Shop.shopPolicies, move it to the returnPolicyProfiles query. You must use return policy profiles to express different return rules for each market.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →