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

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.

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

What’s Changed

Who Is Affected

How to Deploy on a Trial Store

Limitations & Considerations

Next Steps for Developers & Merchants

Conclusion

Related Articles

Secure Your Shopify Admin API Calls with an IP Allowlist

Secure Your Shopify App with Network Access Rules in shopify.app.toml

Auto‑Sync Translations in Translate & Adapt: Up to 8 Languages Now Updated Weekly

Earn Extra Commission with Promoted Placements Beta: Shop Campaigns Now Included