---
title: >-
  Network access declarations are now required for apps that run on the online
  store - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/network-access-declarations-are-now-required-for-apps-that-run-on-the-online-store
  md: >-
    https://shopify.dev/changelog/posts/network-access-declarations-are-now-required-for-apps-that-run-on-the-online-store.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: Platform
    handle: platform
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-11-18T19:25:12-05:00'
  postedAt: '2026-11-19T12:00:00-05:00'
  updatedAt: '2026-11-19T14:31:47-05:00'
  effectiveAt: '2026-11-19T12:00:00-05:00'
---

November 19, 2026

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

DateNovember 19, 2026

FlagsUpdate

Tags[Security](https://shopify.dev/changelog?filter=security)Platform

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]`](https://shopify.dev/docs/apps/build/cli-for-apps/app-configuration#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](https://shopify.dev/changelog/posts/test-app-network-access-configuration-on-dev-stores). The preview covers the online store only.
4. Run `shopify app deploy`, and then release the new version.

Here's an example configuration:

```toml
[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](https://shopify.dev/docs/apps/build/security/storefront/declare-network-access). For every upcoming date, refer to [Upcoming security deadlines](https://shopify.dev/docs/apps/build/security#upcoming-security-deadlines).
