Logo

Shopify App IP Whitelisting Deadline Approaches: Must Be Configured by November 20

avatar jayce 16 Nov 2026

On October 27, Shopify was merely “recommending” that public apps configure IP whitelisting; however, the changelog on November 5 changed the wording to “required.” All public apps that call the Admin API must enable this by November 20, 2026, at 23:59 (Eastern Time); those using bulk operations have a one-week grace period until November 12.

The reason is stated at the beginning of the announcement: the busy season is upon us.

What Shopify Is Checking

Once enforcement is enabled, Shopify checks the source IP of every GraphQL and REST Admin API request made with your app token. If the IP is not on the whitelist, a 403 error is returned; if the source address cannot be verified, it also results in a 403. The consequences of token leakage have been downgraded from “account lost” to “can only be used on your own server.”

There are two types of requests that are exempt from this requirement: the access token included in the Send HTTP request action of Shopify Flow, and Admin API requests initiated with a token from a storefront hosted on Oxygen, as the source IP cannot be verified. Teams using these methods will need to switch to server-side forwarding. Direct API access for dev store previews, embedded pages, and POS UI extensions will never be intercepted.

Static IP Configuration in Ten Minutes, Serverless via ASN

The entry point is in the Dev Dashboard: open the app, go to Settings, and click Manage in the IP allowlist section.

For example, a standalone site that creates custom pet portraits runs its backend on two EC2 instances with fixed outbound IPs; simply add both addresses. The rules are: a maximum of 250 entries, one per line; IPv4 mask /16 or narrower, IPv6 /32 or narrower; only fill in public addresses, and for machines behind NAT, fill in the gateway address; ranges must start from the network address, so 203.0.113.0/24 is acceptable, but 203.0.113.7/24 is not; if using IPv6 for outbound, the IPv6 address must also be listed.

For those running on Vercel or AWS Lambda, where the outbound IP changes with each request, allow by ASN: a maximum of 10 ASNs, the AS prefix is optional, but it is recommended to narrow it down by country, also a maximum of 10. Shopify relies on MaxMind GeoLite data to determine the source attribution, and since ASN is a shared network, servers from other companies within the same ASN are also included in the allowance range; if you can use a fixed IP, do not use ASN.

After filling in the details, do not enable enforcement yet; click Run test. Shopify will replay your real traffic from the last 30 days; if there are any addresses that will be blocked, adjust and retest. Once cleared, enable enforcement and save it. Finally, send an Admin API request from outside the whitelist; seeing a 403 means the configuration is complete.

Chain Reaction of Missing the Deadline

Starting November 20, apps that are not configured will be removed from the App Store and prohibited from new installations; merchants will see a notification in Settings > Apps. Stores that already have the app installed will continue to operate as usual. On January 15, 2027, merchants will start receiving warnings in their admin. On April 1, 2027, Admin API requests will be outright rejected, causing the app to stop functioning.

Custom apps are also included in this requirement: to install on stores outside the organization, configuration must be completed by November 20; for those already installed on external stores, the configuration must be completed by January 1, 2027. For apps used only within the organization, this is not mandatory, but the official wording is “highly recommended.”

Merchants can now see the security configuration of their apps in Settings > Apps, including token type and whether there is a whitelist, all at a glance. Buyers cannot see this, but those making technical selections for the store can.

The ASN determination relies on MaxMind’s data; edge addresses that cannot find ASN or country will be directly rejected, and the official error rate has not been disclosed. The Run test replay only covers 30 days; I have not yet verified if that is stable enough, so keep an eye on the API logs during the first week after configuration.

References:

  • https://shopify.dev/changelog/blog/app-security-updates-ip-allowlist-is-now-required
  • https://shopify.dev/docs/apps/build/dev-dashboard/ip-allowlist
Tags
App Security
IP Allowlist
Admin API
shopify
跨境电商
Book Free 30-Min Call