Executive summary
- What: An app's Settings page in the Dev Dashboard now has an IP allowlist. With enforcement on, Shopify checks the source address of every GraphQL and REST Admin API request made with that app's tokens and returns 403 for anything outside your ranges.
- Why: It narrows the blast radius of a leaked credential: a token lifted from logs or a misconfigured secret store cannot reach the Admin API from anywhere but your own servers.
- Who: Any app calling Shopify from static, public addresses, which describes most self-hosted integration middleware and private apps behind a corporate egress.
What changed
You enter addresses or CIDR ranges, up to 100 lines, then test them against the last 30 days of your own traffic before enabling enforcement. The rules are specific: /16 or narrower for IPv4, /32 or narrower for IPv6, public addresses only, each range starting at its network address. Servers behind a NAT gateway need the gateway's addresses, and anything reaching Shopify over IPv6 needs those listed too.
Shopify will not read ranges from a provider's published IP list, and the reasoning is worth repeating to your hosting team: those lists are shared. A cloud region's outbound addresses serve every customer in that region, so a stolen token still works for anyone behind the same egress. Route Shopify traffic through a dedicated static address instead and list that.
Three cases do not work today. Serverless platforms with rotating addresses are unsupported. Tokens used by the Flow Send HTTP request action are rejected, as are Admin API calls from an Oxygen-hosted storefront, because Shopify cannot confirm their source. Dev preview requests and Direct API access from embedded pages are never rejected.
Why it matters
Access tokens are bearer credentials: whoever holds one is the app, with every scope the merchant granted, and until now the only real mitigations were rotation and vigilance. An allowlist makes the token useless without network position, the same reasoning behind restricting database access to known subnets.
For enterprise merchants the relevance sits in the integration layer. The systems holding long-lived Admin API tokens are usually the ones syncing orders and inventory with an ERP or OMS, and those run on predictable infrastructure with stable egress. If you are scoping an ERP integration, a dedicated egress address and an allowlist belong in the build, not a later hardening pass.
Role-specific impact
- Marketers: no direct impact, with one caveat. If a marketing tool reaches the Admin API through a Flow Send HTTP request action, enforcement rejects it, so raise that before anyone enables the switch.
- Developers: confirm your egress is actually static before enforcing, and remember test results take a few minutes to include recent requests. Pair the allowlist with expiring offline tokens so a leaked credential is limited by both location and lifetime.
- Store admins: ask integration owners whether Shopify traffic leaves from a dedicated address. If the answer is a shared cloud range, the allowlist buys far less than it appears to, and the fix is a networking change, not a Shopify setting.
Use-case example
Real-world scenario
A Plus distributor runs order and inventory sync through middleware on two servers behind a single NAT gateway, holding a token with read and write access across products, inventory, orders, and customers. The team enters the gateway address as a /32, runs the 30-day traffic test, and finds a stray call pattern from an undocumented staging host, the sort of discovery that justifies the exercise on its own. They add staging, re-test clean, enforce, then verify from outside and get the expected 403. The token is now useless without a position inside that gateway.
Implementation checklist
- Convert your ranges to CIDR notation, /16 or narrower for IPv4 and /32 or narrower for IPv6, each starting at its network address.
- In the Dev Dashboard, open the app, then Settings, then Manage in the IP allowlist section, and enter the ranges one per line.
- Run the test against recent traffic and resolve anything that would be blocked, allowing a few minutes for recent requests to appear.
- Enable enforcement, save, then request from outside the ranges and confirm a 403.
FAQ
Q: Our integration runs on serverless functions. Can we use this?
A: Not yet, though Shopify says support is coming. The workable path today is routing outbound calls through a fixed egress, such as a NAT gateway or a small proxy on static infrastructure.
Q: Does enforcement affect our staff using the Shopify admin?
A: No. It applies to Admin API requests made with that app's access tokens, not staff sessions. Embedded pages using Direct API access are also exempt.
Resources
Restrict API access with an IP allowlist
Need guidance? Talk to Makro.