Downgrade app access scopes from write to read
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on October 07, 2026.
This Shopify update is categorized as API, New, GraphQL Admin API, 2027-01.
What changed
The mutation affects only the calling app’s installation. Requested scopes must be declared in optional_scopes and must be write scopes with matching read scopes. Required scopes can’t be downgraded. Write scopes that aren’t currently granted are ignored. If any requested scope fails validation, the request is rejected and the installation’s scopes remain unchanged.
Who is affected
This change applies to apps that use Shopify-managed installation and declare optional write scopes with corresponding read scopes. The mutation is available starting with Admin GraphQL API version 2027-01.
What action may be needed
If your app no longer needs write access, call appDowngradeAccessScopes with the optional write scopes you want to downgrade. For example, downgrade write_products to read_products when your app no longer needs to create or update products: mutation { appDowngradeAccessScopes(scopes: ["write_products"]) { downgraded { handle } userErrors { field message } } } The downgraded field returns the write scopes that were successfully changed. Check userErrors for any validation failures.
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 →