Shopify is tightening security for any app that injects code into a storefront. Starting December 1, 2026, apps that run on the online store must include a network_access declaration in their shopify.app.toml file. This change protects merchants from malicious scripts and gives Shopify a clear picture of which servers an app talks to. In this post we break down the update, who needs to act, and exactly what steps you should take to stay compliant.
What Changed?
Shopify introduced a new required section called [network_access] in the app configuration file. Inside this section you must list every external host your app loads code from or sends API requests to, using the allowed_sources array. You can also (optionally) list domains that your app links customers to in allowed_navigation_hosts. An empty allowed_sources array counts as a declaration if your app does not communicate with any outside server. Without this declaration, Shopify will reject deploys and eventually delist the app.
Who Is Affected?
The rule applies to:
• Public apps listed in the Shopify App Store
• Custom apps that are installed on stores outside your organization
If your app uses any of these features, it falls under the new requirement:
– Theme app extension blocks or app embeds– Script tags injected into the online store– App proxies– The write_themes access scope– Web pixels with the write_open_pixels scope
Apps that only write data (e.g., metafields, products) or that have a checkout UI extension without any of the above features are unaffected. Custom apps used solely within your own organization are also exempt.
Timeline & Deadlines
Shopify has set two hard dates:
• December 1, 2026 – Deploys are rejected for apps missing the declaration. Public apps also show a warning in the merchant admin and can’t be submitted to the App Store.
• January 1, 2027 – Public apps that are still non‑compliant are delisted and blocked from new installs. Custom apps installed outside your organization are blocked from new installs until every in‑scope app declares its network access.
How to Add the Declaration
Here’s a minimal example:
[network_access]
allowed_sources = ["https://api.app.example.com", "https://cdn.example.com"]
allowed_navigation_hosts = ["app.example.com", "support.example.com"]
Testing & Validation
Shopify provides a Network access testing preview that runs on a dev store and checks the online‑store experience. Enable the preview in the Partner Dashboard, install the app on a test store, and verify that no warnings appear. If you see a warning, double‑check that every external URL is listed exactly as it is used (including trailing slashes).
What Merchants Need to Do
While the primary responsibility lies with developers, merchants should be aware of the upcoming warnings in their admin panel. If you see a “Network access declaration missing” banner, reach out to the app’s developer and request an update before December 2026. Keeping apps compliant ensures a smoother checkout experience and avoids unexpected app removals.
Conclusion & Next Steps
Network access declarations are a small addition that yields big security benefits for both merchants and developers. Update your shopify.app.toml today, test on a dev store, and push a new version before the December 1, 2026 cut‑off. Doing so protects your users, keeps your app visible in the App Store, and aligns your workflow with Shopify’s evolving security standards.
Need help updating your configuration? Drop a comment below or reach out to our Shopify development consultancy for a quick audit.
