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

    Embedding YouTube & Vimeo Directly via File Reference Metafields in Shopify API 2027-01

    Embedding YouTube & Vimeo Directly via File Reference Metafields in Shopify API 2027-01

    Shopify’s 2027-01 API now lets file reference metafields store YouTube and Vimeo video URLs, unlocking seamless video embeds for merchants and developers. Learn what changed, who it affects, and how to implement the new feature today.

    November 20, 20265 min
    Why Your Shopify App Must Enable IP Allowlist by Tomorrow (Nov 20 2026)

    Why Your Shopify App Must Enable IP Allowlist by Tomorrow (Nov 20 2026)

    Shopify’s latest security deadline forces public and custom apps to add an IP allowlist. Learn what changed, who’s impacted, and step‑by‑step how to stay compliant before the November 20 cut‑off.

    November 19, 20265 min
    Show Image Swatches for Product Options via the Catalog API

    Show Image Swatches for Product Options via the Catalog API

    Shopify’s Catalog API now returns image swatches for product option values, letting developers display color or pattern previews directly in pickers. Learn what changed, who it impacts, and how to implement swatches with zero‑effort updates.

    November 19, 20264 min
    Multiple Error Reporting Now Available for Function Settings Extensions

    Multiple Error Reporting Now Available for Function Settings Extensions

    Shopify’s latest developer update lets function‑settings extensions return several validation errors at once, giving merchants instant feedback on every issue. Learn what changed, who it impacts, and how to implement the new AggregateError pattern today.

    November 19, 20265 min