Test Your App’s Network Access Settings Directly on Dev Stores

Learn how Shopify’s new network access testing preview lets developers validate allowed hosts and sources on a dev store, avoid navigation warnings, and keep merchant sites secure.

Test Your App’s Network Access Settings Directly on Dev Stores
6 sections

Shopify just rolled out a powerful preview feature that lets you test an app’s network_access settings right on a development store. If your app links to external resources—or makes API calls from a storefront page—this tool helps you confirm that every host and server is correctly whitelisted, preventing unwanted exit warnings and spotting potential security gaps before you go live.

What Changed

When you create a dev store with the network_access_testing feature preview enabled, Shopify adds two non‑blocking safety nets:

  • Exit‑warning validation – Any link that points to a host not listed in allowed_navigation_hosts will trigger the familiar exit‑warning overlay. This lets you see exactly which links would prompt a merchant’s customers to confirm navigation.
  • Console warnings for disallowed sources – The browser console logs a warning whenever a storefront page loads assets or sends requests to a domain not present in allowed_sources. The preview only warns; it does not block the request, so you can safely test without breaking functionality.
  • Both checks run automatically as you browse the dev store, giving you real‑time feedback on any missed hosts or servers.

    Who’s Affected

    Any public or private app that renders storefront content, injects scripts, or fetches data from external endpoints should use this preview. The feature is especially critical for:

  • Developers building rich‑media themes, custom UI extensions, or checkout integrations that rely on third‑party APIs.
  • Merchants who install apps that embed external widgets, because properly configured network settings reduce the chance of confusing exit warnings for shoppers.
  • Shopify recommends every app adopt these settings to keep navigation experiences smooth and to help the platform flag suspicious outbound traffic.

    How to Enable the Network Access Testing Preview

  • Create or open a dev store in your Partner Dashboard.
  • Add the preview flag. In the store’s URL, append the query parameter ?preview=network_access_testing or enable it via the Store Settings → Features panel (look for “Network access testing”).
  • Deploy your app to the dev store as you normally would—via the “Add app” flow or by installing a custom app.
  • Navigate the storefront. Open any page that your app touches. Watch for two things:
  • The exit‑warning overlay appears only for links not in allowed_navigation_hosts.
  • The browser console (Chrome DevTools > Console) logs messages like [Shopify Network Access] Request to unlisted host xyz.example.com for any request outside allowed_sources.
  • Iterate. Add missing hosts to your app’s network_access object, reload the page, and repeat until no warnings appear.
  • Sample network_access Configuration

    Your app’s shopify.app.toml (or the JSON manifest for a custom app) should contain a network_access section. Below is a minimal example that covers both navigation and source allowances:

    toml

    [network_access]

    # Domains that can be navigated to from a storefront link without showing an exit warning.

    allowed_navigation_hosts = ["cdn.example.com", "shopifycdn.com"]

    # Domains that the storefront is allowed to fetch resources from (scripts, images, APIs).

    allowed_sources = ["api.example.com", "assets.example.com", "fonts.googleapis.com"]

    If you add a new third‑party analytics script, for instance, remember to list its host in allowed_sources. Likewise, any affiliate link that redirects shoppers off‑site must be added to allowed_navigation_hosts to avoid the default warning.

    Best Practices for Ongoing Compliance

  • Keep the list lean – Only whitelist the domains you truly need. A smaller surface area reduces the risk of malicious redirects being inadvertently allowed.
  • Automate checks – Incorporate a CI step that parses your manifest and asserts that every external request in your codebase has a corresponding entry in allowed_sources. This catches accidental additions early.
  • Monitor console warnings in production – The preview is a safety net for development, but you can also enable console warnings on staging stores to catch edge‑case calls that only fire under certain user flows.
  • Document external dependencies – Maintain a short README section listing each third‑party service, its purpose, and the host name. This makes future updates easier for any developer on the team.
  • Conclusion & Next Steps

    The network access testing preview gives you confidence that your app’s external calls are transparent and safe before you ship to live merchants. By iterating through the warnings, updating your network_access manifest, and following the best‑practice checklist, you’ll reduce friction for merchants, keep shoppers safe, and stay aligned with Shopify’s security standards.

    Ready to put the feature to work? Enable the preview on a dev store today, run through the steps above, and share your findings with the Shopify Partner community. Happy coding!

    Tags
    Sources

    Related Articles

    CurrentEntryChange Now Returns the Previous Page – What Developers Need to Know

    CurrentEntryChange Now Returns the Previous Page – What Developers Need to Know

    Starting with API version 2027-01, the Navigation API’s currententrychange event now reports the page a customer left instead of the page they navigated to. Learn how this breaking change impacts full‑page account extensions and how to update your code before the upgrade.

    October 31, 20263 min
    UI Extensions Can Now Host Unlimited Locale Files—No More 256 KB Ceiling

    UI Extensions Can Now Host Unlimited Locale Files—No More 256 KB Ceiling

    Shopify has removed the 256 KB combined size limit for UI extension locale files, letting developers add more languages without trimming translations. Learn what changed, who it affects, and how to expand your extensions instantly.

    October 30, 20264 min
    Track with Shop Expands to Japan and Singapore – What Merchants Need to Know

    Track with Shop Expands to Japan and Singapore – What Merchants Need to Know

    Shop’s Track with Shop feature now supports buyers in Japan and Singapore and offers a Japanese‑language experience. Learn how this rollout affects your store, the steps to enable it, and the developer tweaks you may need.

    October 30, 20264 min
    Trusted Vault Origin Signal Empowers Credit Card Payments in Shopify Payments Apps

    Trusted Vault Origin Signal Empowers Credit Card Payments in Shopify Payments Apps

    Shopify’s new trusted_vault_origin flag gives payment app developers a reliable way to handle missing CVV for vaulted cards. Learn what changed, who’s affected, and how to update your integration today.

    October 30, 20265 min