Why Network Access Declarations Are Now Mandatory for Online Store Apps

Shopify now requires apps that run on the online store to declare their network access in shopify.app.toml. Learn what changed, who’s affected, and how to update your app before the December 2026 deadline.

Why Network Access Declarations Are Now Mandatory for Online Store Apps
7 sections

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

  • Identify every external endpoint your app contacts. This includes API servers, CDNs, image hosts, analytics services, or any third‑party scripts.
  • Open your app’s shopify.app.toml file and add a [network_access] section. Populate allowed_sources with fully qualified URLs (including protocol) and, if you wish, allowed_navigation_hosts with domains you link to.
  • If your app does not reach any outside server, declare an empty list – allowed_sources = [] – to satisfy the requirement.
  • Run shopify app deploy to push the change and then release a new version through the Partner Dashboard.
  • 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.

    Tags
    Sources

    Related Articles

    Understanding the New applyResult Field in RolloutChange: What Developers Need to Know

    Understanding the New applyResult Field in RolloutChange: What Developers Need to Know

    Shopify’s GraphQL Admin API now returns an applyResult field on RolloutChange, letting apps track rollout outcomes in real time. Learn what changed, who it affects, and how to update your code to handle success, failure, and in‑progress states.

    November 19, 20264 min

    November 19, 20261 min
    Store Credit Now Powers Shopify Subscriptions with allowStoreCredit

    Store Credit Now Powers Shopify Subscriptions with allowStoreCredit

    Shopify’s 2027-01 API adds store‑credit support to subscriptions via the allowStoreCredit flag. Learn what changed, who’s impacted, and how developers can enable this new feature in minutes.

    November 19, 20265 min
    Why `abandonedCheckoutUrl` Now Needs Level 2 Protected Customer Data Access (and What to Do)

    Why `abandonedCheckoutUrl` Now Needs Level 2 Protected Customer Data Access (and What to Do)

    Starting Dec 1 2026 for public apps, Shopify requires level 2 protected customer data access to read abandonedCheckoutUrl. Learn who is affected, why the change matters, and how to update your app before the deadline.

    November 19, 20264 min