When exactly do I need the write_app_proxy scope?

Topic summary

Shopify notified app developers that the write_app_proxy scope will be required starting November for apps using app proxies. The original poster’s app displays dynamic content via app proxy without editing store data, raising confusion about whether the scope is necessary.

Initial confusion:

  • Documentation stated the scope is for “editing page content,” which sounded more invasive than simply displaying content
  • The permission request message shown to merchants appeared concerning, suggesting the app would modify store data

Community responses:

  • One user suggested the scope is only needed if the app edits something, citing Shopify docs
  • However, this contradicted the notification requiring it for all app proxy usage
  • Multiple developers shared concerns about requesting new permissions from existing merchants, fearing it would appear suspicious

Resolution:
Shopify updated their documentation in August to clarify: the scope is required for all apps using app proxies, not just those editing content. The updated docs explicitly state apps displaying dynamic data through proxies need this scope.

Status: Resolved through documentation update, though concerns remain about how the permission request appears to merchants.

Summarized with AI on October 25. AI used: claude-sonnet-4-5-20250929.

Shopify sent me this notification:

We provide an app that displays dynamic content on a store. The content is fetched from our server via an app proxy. We do not edit anything about the store, but we fetch the products. The documentation says this about that scope:

And when I add the scope to a development store the store admin gets this message:

This sounds concerning. Like we now want to edit their store data! (Ignore the yellow part, that’s because its an unpublished development app where I test things.)

So do I actually need that scope?

(Is this the correct place to ask this? If not, what is?)

1 Like

Hi @bloodyalbatross
You have to add this write_app_proxy as well to your app scopes list
Thanks!

Do I have to add it for any app that uses an app proxy or only if it edits something?

Hi @bloodyalbatross

Only if it edits something

Thanks :+1:

Are you employed by Shopify? If not, where do you have your information from? I just want to be sure that the app doesn’t just stop working come November. Thank you!

I got this information from Shopify docs: https://shopify.dev/docs/api/usage/access-scopes

You can read more about it from here and if you are still unsure then you can reach Shopify support to get the better answer

Thanks

I.e. what I referenced in my initial question and what I feel isn’t precise enough in the context of the notification.

I am in a similar situation and would like to know more what means ‘edit page content’ and how this access scope will control that?

I assume any use of the app proxy already requires this scope, but would like to get this confirmed.

1 Like

Hey,

Did you find an answer to this?

I am also wondering and couldn’t find an answer.

Additionally I was thinking perhaps for installed shops this can be done by API so we won’t need to suddenly ask them for permission and they might think we changed something in the app.

Amos

No, I was hoping I will get an answer here before November.

I tested it on a development version of our app. Just added the new scope and deployed the theme extension. The next time I opened the app admin page of a store with that app installed I got the message that I posted above.

Someone on Mastodon said, that they’re a store admin, not a app dev, and as such they are just trained to click yes to everything. I.e. they think it won’t be too bad. But still, I only want to request the scopes that we really need.

Yeah I mean I’m more curios if the app will work without asking for the new scope.

I assume it won’t, and to be honest I do understand how Shopify see that if the app adds any content on the storefront (that’s what the proxy is for) then they consider it “editing the storefront” and I’m OK with it (although the text is a bit alarming, it makes it sounds like we’re changing the content of their store which we’re not and proxy doesn’t even allow it).

My biggest issue is the fact you have to ask this new permission also from CURRENT stores as this will look to them like we’ve changed something and that from now on we’re starting to change their storefronts… which of course we don’t.

2 Likes

They have updated the text in the documentation:


https://shopify.dev/docs/api/usage/access-scopes#authenticated-access-scopes


https://shopify.dev/docs/apps/build/online-store/display-dynamic-data

This sounds clear to me. We need to add that scope. Wonder if they’ve also changed the text merchants will see after adding that scope.

I’ve just tested it, and the text customers see is still the same, unfortunately. I wish the scope could be listed in “optional_scopes” rather than the required “scopes”, but that doesn’t seem to be the case, according to the example. Most of my app’s customers don’t even use the feature, but all of them will soon see how the app could potentially destroy their online store (at least, based on the text in the data access popup).