How to Choose the Right Headless Shopify Agency

Here is the uncomfortable part of hiring a headless Shopify agency: the agency has a financial incentive to say yes to headless, because headless is where the big invoices live. So the first thing to vet is not their portfolio — it is whether they will tell you the truth about whether you need headless at all, and who is going to run this complex setup after they hand it over.

Headless Shopify is a significant technical and financial commitment. Choosing the wrong agency results in a slow Next.js app that’s harder to maintain than your Liquid theme was, or a project that stalls because the team didn’t understand Shopify’s API limitations.

Choosing the right agency delivers sub-second page loads, a flexible content architecture, and a frontend your in-house team can actually maintain. This guide gives you the framework to tell them apart.

Key Takeaway:

First: Is Headless Right for Your Store?

Before evaluating agencies, confirm headless actually serves your business goals. Headless makes sense when you have:

  • Traffic volume where Core Web Vital scores directly impact revenue (50,000+ monthly sessions)
  • Complex content requirements that exceed Liquid’s capabilities (rich editorial, multimedia, personalisation)
  • Multi-channel requirements (same content API serving web, mobile app, kiosk, etc.)
  • Custom checkout experiences beyond what Shopify Checkout Extensibility supports
  • A technical team capable of maintaining a React/Node infrastructure

If your store is under $5M ARR with straightforward content needs, a well-optimized custom Shopify theme will outperform a mediocre headless build. Headless amplifies good execution; it doesn’t compensate for poor execution.

Stack Evaluation: Next.js vs Hydrogen

Criterion
Next.js + Storefront API
Shopify Hydrogen
Framework
Next.js + Storefront APINext.js (Vercel)
Shopify HydrogenRemix (Shopify)
Shopify integration
Next.js + Storefront APIVia Storefront API + custom hooks
Shopify HydrogenBuilt-in hooks, components, utilities
Ecosystem maturity
Next.js + Storefront APIVery large (React ecosystem)
Shopify HydrogenGrowing, Shopify-specific
Deployment
Next.js + Storefront APIVercel, Netlify, any Node host
Shopify HydrogenShopify Oxygen (or self-host)
CMS flexibility
Next.js + Storefront APIAny headless CMS
Shopify HydrogenAny headless CMS
Developer availability
Next.js + Storefront APIVery high
Shopify HydrogenLower (Remix expertise required)
Vendor lock-in
Next.js + Storefront APILow (switch CMS/backend easily)
Shopify HydrogenMedium (Shopify stack)

The Agency That Should Be Willing to Talk You Out of It

A headless agency earns its best margins on complexity, and that creates a quiet conflict of interest: the more they can talk you into a full custom Next.js build, the bigger the invoice. So the single most useful signal to watch for is an agency willing to tell you that you do not need headless. Most Shopify stores do not — a fast custom Liquid theme gets them the speed and design they are chasing without the operational overhead. An agency that hears “$400k store, thinking about headless” and immediately says yes, without qualifying your traffic, team, and maintenance capacity, is optimizing for their invoice, not your outcome.

The second question outlasts the build: who runs this after handoff? A custom Next.js storefront is genuinely complex and needs someone who knows that stack to maintain it. Ask whether they build on a standard, documented stack or a proprietary one only they can touch, whether you get real handoff docs, and what the maintenance path looks like if you ever part ways. A slow or unmaintainable Next.js app is worse than the Liquid theme you left. If you genuinely need it, our own headless Shopify work is built to be handed off, not to lock you in.

Technical Questions to Ask Any Headless Agency

Shopify API Expertise

  1. “How do you handle Shopify Storefront API rate limiting and caching?”
  2. “How do you implement cart persistence and session management without cookies?”
  3. “How do you handle product variants with complex options in Next.js?”
  4. “Can you show me how you’ve implemented collection filtering with the Storefront API?”
  5. “How do you handle metafields and metaobjects in your frontend layer?”

Frontend Performance

  1. “What Lighthouse scores do your headless builds typically achieve on mobile?”
  2. “How do you handle ISR (Incremental Static Regeneration) for product and collection pages?”
  3. “How do you manage image optimization — next/image with Shopify CDN?”
  4. “Can you show a real PageSpeed Insights URL from a headless store you’ve built?”

CMS Integration

  1. “Which headless CMS platforms have you integrated with Shopify?”
  2. “How do you handle preview mode for content editors?”
  3. “How does your architecture handle CMS + Shopify data on the same page (e.g., editorial product pages)?”

Portfolio Evaluation for Headless Agencies

What to Look For

  • Live headless Shopify stores (not demos or staging)
  • PageSpeed Insights mobile scores above 80 on portfolio stores
  • Evidence of CMS integration (Contentful, Sanity, Prismic)
  • Complex product catalogue handling (configurable products, bundles)
  • GitHub repositories or code samples (even partial)

Red Flags in Headless Agency Portfolios

Watch for these warning signs:
  • Portfolio sites have poor Core Web Vitals despite claiming to be headless (“headless” built with iframes)
  • Only demo stores — no live, high-traffic production examples
  • Agency presents a Shopify theme as “headless” because it uses sections/JSON
  • Unable to articulate Storefront API caching strategy
  • No mention of ISR, SSG, or edge rendering — suggesting server-rendered pages that don’t scale
  • They recommend headless for a 500-SKU store with basic content needs

Pricing Reality Check

Understand what you’re paying for in headless versus traditional Shopify development:

  • Custom Shopify theme: $15,000–$40,000 — lower build cost, simpler maintenance, merchant-editable via Shopify admin
  • Headless (Next.js + Storefront API): $40,000–$150,000+ — higher build cost, more complex maintenance, developer-required for many changes
  • Headless ongoing maintenance: $3,000–$10,000/month for an agency retainer; $8,000–$15,000/month for a FTE frontend developer

Factor in the ongoing cost. Headless isn’t “build once and forget.” It requires regular dependency updates, performance monitoring, and feature development that a standard Shopify theme doesn’t require.

Contract and Delivery Considerations

  • Require performance SLAs in the contract (e.g., LCP < 2.5s on mobile, Lighthouse ≥ 80)
  • Ensure IP transfer covers all custom code and configuration
  • Request code handoff with documentation — you must be able to hire another developer to continue the project
  • Confirm deployment infrastructure setup is included (Vercel/Netlify config, CI/CD pipeline)
  • Require a knowledge transfer session with your internal team before final payment

Frequently Asked Questions

A headless Shopify agency builds the custom frontend (typically Next.js or Hydrogen) that connects to Shopify’s Storefront API as the backend. They handle React development, SSR/ISR performance, Shopify API integration, CMS setup, and ongoing frontend maintenance.

Probe their real Shopify and frontend depth: how they handle the Storefront API and cart/checkout (checkout stays on Shopify — can they explain why), how they manage caching and SSR/ISR for fast Core Web Vitals, how they connect a headless CMS for editable content, and how they handle SEO (server-rendering, metadata, redirects, structured data). Ask for a real Lighthouse score on a site they shipped, not a demo. Vague answers on caching, SEO, or checkout are the clearest reason to walk away.

Watch for: no live headless sites in the portfolio (only standard themes), inability to show real performance numbers, treating SEO as an afterthought, no clear plan for editable content via a CMS, and proposing headless when your store doesn’t actually need it. Other warnings: hand-wavy answers about checkout, no staging or QA process, and pricing far below market — headless is expensive to do well, and a cut-rate quote usually means a hard-to-maintain build.

Both are valid. Next.js is more flexible, has a larger ecosystem, and is familiar to most React teams. Shopify Hydrogen (built on Remix) has tighter Shopify integration with purpose-built hooks and components but ties you more closely to Shopify’s stack. For most brands, Next.js offers more long-term flexibility.

No — the Shopify Storefront API is available on all plans. However, Shopify Plus provides additional headless capabilities: checkout extensibility, multipass login, B2B APIs, and dedicated account management. Most high-revenue headless brands are on Plus.

A skilled freelancer can work for a focused, well-scoped headless project if they have proven Shopify + Next.js/Hydrogen work and you can manage them. For most builds, an agency is safer: headless spans frontend, Shopify backend, CMS, DevOps, and SEO, which is a lot for one person to own and support long-term. Agencies also give continuity if someone leaves. Match the choice to scope and your own ability to manage the work.

Most headless Shopify builds run roughly 2–4 months to launch, depending on the number of templates, integrations (CMS, search, reviews, subscriptions), and how much custom UX is involved. A focused Hydrogen storefront with few integrations can be faster; a complex Shopify Plus build with bespoke functionality takes longer. Budget extra time for performance tuning, SEO and redirect setup, and QA — that’s where headless timelines most often slip.

Headless Shopify projects typically start at $30,000–$50,000 for a well-scoped frontend build, and can reach $100,000–$300,000+ for complex implementations with custom CMS, internationalisation, and integrations. Ongoing maintenance runs $3,000–$10,000/month.

You likely need headless if you require a highly custom front-end experience, top-tier performance, content from multiple sources, or omnichannel delivery, and you have the budget and team to maintain a separate front end. If a well-optimized Shopify theme meets your needs, headless is usually unnecessary overhead – a good agency will tell you honestly.

Headless storefronts need ongoing front-end development: framework and dependency updates, hosting and build pipeline upkeep, monitoring, and rebuilding features that themes provide out of the box. Factor this continuous cost in – it is the main trade-off versus a standard Shopify theme.

A competent agency implements server-side rendering or static generation, clean URLs, correct meta tags and canonical handling, structured data, fast Core Web Vitals, and proper redirects on launch. Ask specifically how they prevent the SEO pitfalls of client-only rendering, since this is where many headless builds go wrong.

A solid proposal defines scope and features, the tech stack and hosting, an SEO and performance plan, timeline and milestones, who owns the code, testing and QA, launch and redirect strategy, and post-launch support and costs. Vague proposals with no SEO or maintenance plan are a red flag.

Watch whether they are willing to tell you that you do not need headless. Headless agencies earn their best margins on complexity, so one that says yes to a full Next.js build without qualifying your traffic, team, and maintenance capacity is optimizing for their invoice. Then ask who maintains the store after handoff: a custom headless storefront needs someone who knows that stack, so confirm they build on a standard, documented stack rather than a proprietary one, that you get real handoff docs, and that there is a maintenance path if you part ways. A slow, unmaintainable Next.js app is worse than the Liquid theme you left.

Related Resources

Our Headless Shopify Service

Next.js + Storefront API builds with proven performance results.

View service

Headless Shopify Guide

Architecture, stack options, and when headless makes sense.

Read article

Shopify Plus Development

Shopify Plus features that pair well with headless architecture.

View service