Service eligibility and regional restrictions
PuppyIP serves only compliant overseas businesses and their authorized personnel. Proxy services are not available in mainland China. The service may only be used for lawful business activities outside mainland China. Use of this service within mainland China is prohibited.
Hosting a proxy IP or server overseas does not change these restrictions. The service must not be provided to end users in mainland China through relaying, forwarding, sharing or resale. Before use, read the Terms of Service.
Key Takeaways
- The feature applies to apps using Shopify-managed installation. Only the calling app’s current installation changes.
- Declare each requested write scope in optional_scopes and check that it has a matching read scope. Required scopes cannot be downgraded.
- A validation failure rejects the entire request. A valid optional write scope that was never granted is ignored.
- Query currentAppInstallation before and after testing to confirm the effective grants.
When should you downgrade a write scope?
Shopify’s October 7, 2026 announcement describes the option for apps that still need to read data after they stop editing it. For example, a store may disable product editing while keeping a product catalogue view. If that installation meets the conditions, the app can replace optional write_products with read_products.
A write scope includes its corresponding read access. If you use appRevokeAccessScopes to remove the write scope and the write scope was the only source of read access, revoking it removes that read access as well. Test the downgrade on the release candidate if the app still needs to read.
What should you check before calling the mutation?
Verify that the app uses Shopify-managed installation and that each target scope is declared in optional_scopes in the app settings. The target must be a write scope with a matching read scope in Shopify. A required permission under scopes cannot be downgraded through this mutation.
Check which scopes the current installation actually has. Use currentAppInstallation to confirm the installation and its grants. Optional scopes are available to request, but the merchant may not have approved them. The call changes only the installation that makes the request. Evaluate other stores separately.
What happens if one scope in the batch is invalid?
If any requested scope fails validation, Shopify rejects the entire request and the installation’s permissions stay as they were. For example, submitting an eligible optional write_products scope alongside a required write scope cannot apply the first change independently. Correct the request and check the current grants again.
Shopify ignores a valid requested write scope that is not currently granted. Verify which scopes actually changed and which were absent beforehand, then refresh your app’s view of permissions for that installation.
How can you test that reads still work and writes stop?
Use the 2027-01 release candidate on an authorized development store. Record the current grants and identify tasks, background jobs and interface controls that depend on the write scope. Then call appDowngradeAccessScopes on the test installation.
Query the effective grants afterwards, verify that the corresponding reads still work and confirm that app features requiring write access are hidden or disabled as expected. If the merchant later needs to re-enable writing, use the existing optional-scope flow to ask for authorization.
Test background writes separately. For example, if a product sync still writes to the catalogue, disable it on the test installation and confirm the read-only view still works. Hiding an editing control alone can leave queued writes running.
Sources
Frequently Asked Questions
Will older apps be automatically downgraded on January 1, 2027?
Shopify says existing apps do not need to take action. An eligible app explicitly requests a downgrade on the current installation.
Can I replace any write scope with an unrelated read scope?
The mutation supports a write scope and its Shopify-defined matching read scope. Check the current scope definitions before making a request.