Deploy Hydrogen to Oxygen on Trial Stores – What You Need to Know

Shopify now lets developers deploy Hydrogen storefronts to Oxygen from trial plan stores, removing the paid‑plan barrier. Learn who’s affected, how to set up, and what limits to watch.

Deploy Hydrogen to Oxygen on Trial Stores – What You Need to Know
6 sections

Shopify’s latest developer changelog removes a key hurdle: trial plan stores can now deploy Hydrogen storefronts to Oxygen. This opens up full‑stack development on a free store, letting you test and showcase custom storefronts without upgrading to a paid plan.

What’s Changed

Previously, Oxygen hosting required a paid Shopify plan. The new update expands Oxygen availability to trial stores, meaning you can spin up a Hydrogen project, push it to Oxygen, and view the live URL—all from a store that’s still on the free trial.

Who Is Affected

This change is aimed at two audiences:

  • Developers building custom storefronts who want a zero‑cost environment for prototyping or client demos.
  • Merchants who are experimenting with Hydrogen but haven’t yet committed to a paid plan. The update does not affect existing Oxygen customers on paid plans—they continue to have the same capabilities, including public environments.
  • How to Deploy on a Trial Store

  • Ensure your trial store has the "Hydrogen" app installed and the Shopify CLI set up.
  • Initialize a Hydrogen project (or use an existing one).
  • Authenticate with the CLI:
  • shopify login --store your-trial-store.myshopify.com

  • Deploy to Oxygen:
  • shopify hydrogen deploy --store your-trial-store.myshopify.com

    The CLI will create an Oxygen environment for you and return a preview URL. Because trial stores lack public environments, the URL will always prompt for a store login before rendering the storefront.

    Example of an optional oxygen.toml configuration you might add to control the build:

    toml

    [build]

    command = "npm run build"

    [environment]

    NODE_ENV = "production"

    Limitations & Considerations

  • No public environments: All preview URLs are gated behind a Shopify login. If you need a shareable public link, you’ll still need a paid plan.
  • Resource caps: Trial stores inherit the standard trial resource limits (e.g., API call quotas). Heavy traffic or extensive build processes may hit these caps.
  • Feature parity: All Oxygen features are available, but advanced add‑ons that require billing (e.g., custom domains) remain unavailable on trial stores.
  • Transition: When you upgrade the store to a paid plan, the existing Oxygen deployment automatically gains a public environment without needing to redeploy.
  • Next Steps for Developers & Merchants

  • Start a sandbox: Spin up a fresh trial store, install the Hydrogen app, and run the deployment steps above to get hands‑on experience.
  • Update your workflow: Document the extra login step in your CI/CD pipelines so teammates know the preview URL isn’t publicly accessible.
  • Communicate with clients: If you’re building for a merchant, explain that the trial preview is secure and only visible to authenticated users; offer a paid‑plan upgrade for a public demo.
  • Monitor limits: Use the Shopify admin’s usage reports to keep an eye on API and build quotas during the trial phase.
  • Conclusion

    The ability to run Hydrogen on Oxygen from trial stores removes a major friction point for developers and merchants eager to experiment with Shopify’s next‑gen storefront platform. While the preview URLs remain login‑protected, you now have a fully functional, cost‑free environment to prototype, test, and showcase custom storefronts. Upgrade to a paid plan when you’re ready for public URLs or advanced features, but until then, make the most of this new trial capability and bring your Shopify storefront ideas to life faster than ever.

    Tags
    Sources

    Related Articles

    Protecting Shoppers: Shopify’s New Confirmation Prompt for External Redirects

    Protecting Shoppers: Shopify’s New Confirmation Prompt for External Redirects

    Shopify now shows a confirmation modal before sending customers to untrusted external sites, helping prevent phishing and unwanted redirects. Learn what changed, who’s affected, and how to keep your store’s experience smooth.

    October 21, 20264 min
    Mastering Stock Counts: New Tools to Create, Manage, and Review Inventory in Shopify Admin

    Mastering Stock Counts: New Tools to Create, Manage, and Review Inventory in Shopify Admin

    Shopify’s latest Stock Count feature brings barcode scanning, real‑time reviews, and audit trails directly into the admin. Learn who it impacts, how to set it up, and what developers need to know.

    October 20, 20264 min
    Unlocking Analytics for Metaobjects: New Queryable Capability in the Shopify Admin API

    Unlocking Analytics for Metaobjects: New Queryable Capability in the Shopify Admin API

    Shopify’s 2027-01 GraphQL Admin API now lets you read and set the analyticsQueryable capability on metaobject definitions, aligning them with metafields. Learn what changed, who it impacts, and how to enable analytics for your custom data.

    October 20, 20263 min
    Securing Your Shopify App: New AI‑Powered Checks and Expiring Tokens

    Securing Your Shopify App: New AI‑Powered Checks and Expiring Tokens

    Shopify’s latest developer update forces app makers to adopt AI security scans, short‑lived access tokens, and tighter account protections. Learn what changed, who’s affected, and how to implement the new safeguards today.

    October 20, 20264 min