Skip to content
Pixeltree

Field notes

Headless Shopify vs Liquid Themes: Which Should You Actually Pick?

August 31, 2025

Headless Shopify vs Liquid Themes: Which Should You Actually Pick?

Headless Shopify (Hydrogen, Next.js, Remix) is the glamorous option. It promises faster load times, richer frontend experiences, and more control. The reality is more nuanced. For 85 percent of boutique ecom brands, a well-built Liquid theme beats a mediocre headless build. For the other 15 percent, headless is genuinely worth the complexity.

Here is how to tell which side you are on.

What each actually is

Liquid themes are Shopify's native templating language. Your theme files live in Shopify admin, Shopify hosts everything, and the architecture is tightly integrated with Shopify's ecosystem.

Headless means you decouple the frontend from Shopify. Your frontend is a separate application (often Next.js, Hydrogen, or Remix) that calls Shopify's Storefront API for data. The frontend is hosted elsewhere (Vercel, Oxygen, Netlify).

The performance claim

Headless is often pitched as faster. The truth is more complicated.

Well-built Liquid theme can hit mobile LCP under 2 seconds, Lighthouse score of 90+.

Well-built headless (Next.js with proper caching) can hit mobile LCP under 1.2 seconds, Lighthouse 95+.

Poorly-built headless can be slower than Liquid because the API roundtrip adds latency if caching is not set up correctly.

The performance advantage of headless is real but requires expertise to capture. A $4,000 Liquid theme with image optimization done right will beat a $30,000 headless build with bad caching.

The real cost difference

CategoryLiquid theme (custom)Headless (Hydrogen/Next.js)
Initial build$8K to $25K$25K to $80K
Maintenance$500 to $2K/mo$2K to $6K/mo
Hosting$0 (Shopify hosts)$20 to $200/mo (Vercel/Oxygen)
Development velocity after launchFast (any Liquid dev can edit)Slower (React dev required)
App ecosystem compatibilityFullPartial (some apps need custom integration)

Over 2 years, the total cost of ownership for a custom headless build is typically 2x to 4x a Liquid theme equivalent.

When headless actually wins

You have a large content operation. If you publish 5+ blog posts per week, run complex landing pages, and have strong editorial needs, the frontend flexibility of React beats Liquid.

You need complex frontend logic. Multi-step configurators, product builders, subscription flows with custom UX, calculator-driven commerce experiences. These are easier in React.

You have an in-house dev team. If you have 2+ engineers who work on the site weekly, the velocity of React in their workflow is higher. They can ship features the Liquid world cannot easily do.

Performance is a measurable revenue lever. If you have evidence that 200ms of load time improvement lifts conversion by 3+ percent and you're at $200K+ monthly revenue, the headless build pays back.

Your brand is content-heavy. Editorial brands, niche publications with commerce bolted on, brand-forward stores where the storytelling layer is as important as the checkout.

When Liquid wins

You do not have an in-house React developer. Every change goes through an agency or freelancer. Liquid is cheaper to hire for and faster to turn around.

Your store is product-catalog-driven. Most boutique ecom is: browse products, add to cart, buy. Liquid handles this extremely well.

You use many Shopify apps. App ecosystem compatibility is stronger in Liquid. Headless often requires custom work to integrate apps that drop into Liquid themes easily.

You value stability over frontend flexibility. Shopify upgrades Liquid themes in the background. Headless requires you to upgrade dependencies, handle Breaking Change warnings, and maintain the frontend stack.

Budget is a real constraint. A headless build under $20K is almost always worse than a Liquid theme at $12K.

Hydrogen specifically

Shopify's Hydrogen (React framework, hosted on Shopify Oxygen) is their answer to the headless question. It solves some problems (Shopify handles hosting, pre-built React components for Shopify data) but has tradeoffs.

Pros: Shopify-native hosting (no separate Vercel account), opinionated framework reduces setup time, tight integration with Shopify.

Cons: Oxygen hosting is less flexible than Vercel, Hydrogen is less mature than Next.js, some Shopify apps still do not have Hydrogen-compatible integrations.

When Hydrogen beats generic Next.js: when you want to stay fully in the Shopify ecosystem and reduce vendor sprawl.

When Next.js beats Hydrogen: when you want to host on Vercel, use their image optimization, and leverage Next.js's larger ecosystem.

The hybrid pattern that is gaining traction

Some brands run hybrid: Liquid theme for core commerce pages (PDP, collection, cart, checkout), React for content-heavy landing pages or custom funnels. This gives you Liquid's app ecosystem where it matters and React's flexibility where it shines.

Tools like Replo, Shogun, and some headless builders support this pattern. Good for mid-size brands that want the best of both without rebuilding the entire frontend.

The decision checklist

Go headless if you check 4 or more of these:

  • Monthly revenue over $200K
  • In-house developer with React experience
  • Content operation that ships 10+ pieces per month
  • Custom frontend logic beyond standard ecom (configurators, quizzes, tools)
  • Willing to invest $40K+ in initial build
  • Willing to spend $3K+/month on maintenance indefinitely
  • Brand is content-driven more than catalog-driven
  • Measurable performance-to-revenue relationship

Stay on Liquid if you check 3 or more of these:

  • Monthly revenue under $150K
  • No in-house developer
  • Standard ecom flow (browse, buy, repeat)
  • Heavy reliance on Shopify apps
  • Budget under $25K for frontend
  • Want faster feature velocity at lower cost
  • Value stability and lower maintenance

Common mistakes with headless

Starting headless when you do not need to. Brands pick Hydrogen because it is fashionable, not because their business requires it. Two years later they cannot afford to maintain it and migrate back to Liquid at significant cost.

Underestimating the API caching work. Shopify Storefront API is not a flat "call and render" setup. You need edge caching, stale-while-revalidate patterns, and incremental static regeneration to get the performance claim.

Skipping image optimization. Headless does not automatically give you images at the right size. You need to configure a proper image pipeline (Shopify CDN parameters, Vercel Image Optimization, or similar).

Losing Shopify app ecosystem benefits. Judge.me, Klaviyo, Searchanise, ReCharge: these integrate differently in headless. Some need custom work. Audit your app stack before committing.

When to migrate

If you are already on Liquid and thinking about headless: do not migrate until a specific business reason forces it. Performance issues you cannot solve in Liquid (rare). Content operation that is bottlenecked by Liquid (rare). Custom frontend logic Liquid cannot handle (occasional).

If you are about to rebuild from scratch anyway: decide up front based on the checklist above.

Our take

We build both. Roughly 80 percent of our client work is Liquid, 20 percent is headless (Hydrogen or Next.js). The split matches where the market actually is.

For boutique brands under $300K per month, we default to Liquid because the math works out better. For brands above that with strong content needs or in-house dev teams, headless starts making sense.

See our Shopify development service for both options.

One-page resource

Get the Vendor Recovery Checklist.

The 12 steps every displaced maker should take in the next 30 days. Delivered in your inbox.

No spam. Unsubscribe any time.

Ready to put this into motion?

Book a 15-min call