How does requesting a new scope affect existing brands?

Topic summary

A developer with an existing Shopify app used by multiple merchants wants to add a new scope to their app’s .toml file. Their main concern is understanding what happens during the interim period after adding the scope but before merchants accept or deny it.

Key questions:

  • Does the entire app get disabled for merchants who haven’t yet responded to the scope request?
  • Or does the app continue functioning normally, with only the new scope’s APIs being inaccessible until approval?

Current status:

  • The developer has searched the documentation but found no specific information addressing this scenario.
  • The question remains unanswered, seeking clarification on Shopify’s behavior during pending scope approval states.
Summarized with AI on October 29. AI used: claude-sonnet-4-5-20250929.

I have designed a shopify app that is used by many brands. I would like to add a new scope to my app, but I am concerned about what happens in between adding the scope to my .toml file, and the merchant accepting or denying the new scope. If the brand has not accepted or denied the new scopes (maybe they haven’t logged in in a while), is my existing app switched off? Or can I just not access APIs that require the new scope? I have tried to look around the documentation and cannot find any specific references to this case.