Skip to main content

Network access declarations are now required for apps that run on the online store

We're adding network access declarations as a requirement to better protect merchants. Apps that run code on the online store must declare allowed_sources in the [network_access] section of shopify.app.toml.

Timeline

Shopify will reject deploys and delist apps that haven't added the required declarations as follows.

Public apps:

  • December 1, 2026: Shopify rejects deploys and Shopify App Store submissions. Merchants see a warning in the Shopify admin. Existing app versions keep working.
  • January 1, 2027: Shopify delists apps from the Shopify App Store and blocks new installs. Existing installs keep working.

Custom apps installed outside your organization:

  • December 1, 2026: Shopify rejects deploys.
  • January 1, 2027: Shopify blocks installs of your apps outside your organization until every app that's in scope declares its network access.

What apps are affected

Public apps, and custom apps that you install on stores outside your organization, are affected if they use any of the following features:

  • A theme app extension block or app embed.
  • Script tags on the online store.
  • An app proxy.
  • The write_themes access scope.
  • A web pixel with the write_open_pixels access scope.

What apps are unaffected

  • Apps that only write content, such as metafields, menus, or products.
  • Apps that have a checkout UI extension but none of the features listed above.
  • Custom apps that you install only on stores within your organization.
  • Apps that merchants create in the Dev Dashboard or in the Shopify admin.
  • Web pixels that run in the default strict sandbox.

Why we're making this change

Injected scripts can load code onto a storefront from any server. Declaring your app's servers helps Shopify spot suspicious requests, which protects your app and the merchants who use it.

What to do

  1. Add the servers that your app's code loads from or sends requests to, such as your API or CDN, to allowed_sources. If your app doesn't contact any external servers, then set allowed_sources = []. An empty list counts as a declaration.
  2. Optional: Add the hosts that your app links customers to, such as your app's own site, to allowed_navigation_hosts. This helps Shopify recognize links to sites that you trust, so customers are less likely to see an exit warning.
  3. Test your configuration on a dev store with the Network access testing preview. The preview covers the online store only.
  4. Run shopify app deploy, and then release the new version.

Here's an example configuration:

[network_access]
allowed_sources = ["https://api.app.example.com"]
allowed_navigation_hosts = ["app.example.com"]

For examples and troubleshooting, refer to Declare your app's network access. For every upcoming date, refer to Upcoming security deadlines.

Was this page helpful?