Liquid or Hydrogen? How I choose for a Shopify storefront

There are two broad ways to build a Shopify storefront: a theme written in Liquid, or a custom (headless) storefront, such as one built with Hydrogen, Shopify's React-based framework for custom storefronts.

I work comfortably in React and Node, and I build Liquid themes day to day. So this isn't a tribe question for me. It's a trade-off. Here's how I weigh it.

What each one gives you

A Liquid theme is rendered by Shopify. The merchant edits sections in the theme editor, apps plug in through app blocks and embeds, and Shopify handles hosting, caching and a lot of storefront plumbing.

A custom storefront is your own application that talks to Shopify's APIs. You control everything about the front end: architecture, interactions, hosting choices, performance strategy. You also own everything that comes with it.

Where Liquid wins

• Speed to launch. A good theme can be live in days to weeks. I've launched more than thirty stores in roughly two weeks each. A custom build rarely gets near that.
• Merchant control. Non-developers can change layout and content in the editor without a deployment.
• The ecosystem. Most apps are built to work with themes. Many work out of the box with Liquid and need extra work, or aren't available, in a custom storefront.
• Lower running cost and risk. Fewer moving parts and a smaller team can maintain it.
• Good enough performance. A well-built theme can be fast, as I describe in the slow-theme checklist.

Where a custom storefront wins

• Highly bespoke experiences. Complex configurators, unusual navigation, app-like interactions, or a design system that a theme fights.
• Content-led or multi-source sites. When the storefront combines Shopify with other data sources.
• Team and architecture fit. An engineering team already invested in React, with the capacity to own a codebase.
• Fine-grained performance control. When the team has specific needs and the skill to meet them.

Where it goes wrong

I'd be cautious about a custom storefront when:

• The reason is "it's modern" rather than a specific requirement.
• The merchant needs to edit pages themselves and there's no plan for that.
• The store relies on many third-party apps that assume a theme.
• There's no ongoing engineering ownership. A custom storefront needs maintenance, upgrades and monitoring, indefinitely.
• The budget would be better spent on content, photography and conversion work.

Questions I ask the client

1. What can't a theme do for you? Be specific.
2. Who will maintain it in two years?
3. Which apps do you depend on, and do they work in a custom storefront?
4. How often will non-developers need to change the site?
5. What are your timeline and budget?
6. What does success look like, in conversion and business terms?

If the answers are vague, I steer toward Liquid, because it's cheaper to start and cheaper to change your mind later.

My default

For most merchants, a well-built Liquid theme on Online Store 2.0 is the right answer. It's fast to ship, easy to edit and widely supported. I reach for a custom storefront when there's a clear requirement a theme can't meet and a team that can own the result.

A note on staying current

Both options keep changing. Shopify is evolving Liquid (new tags are in developer preview) and the custom-storefront tooling alike, so I recheck the current state of both before recommending either. A decision made on last year's trade-offs may not hold.

If you're weighing this for a project or a team, I'm happy to talk it through.