Responsible Shopify engineering starts with ownership, boundaries and validation.
Shopify Development Guide: Themes, Apps, Headless
A practical map of where to build what on Shopify and Shopify Plus, when to use a theme section, when to write a Shopify Function, when to ship an app, and…
Published
Reading brief
What you will get from this guide
A practical map of where to build what on Shopify and Shopify Plus, when to use a theme section, when to write a Shopify Function, when to ship an app, and…
What this guide covers
Persistence, rendering surface, checkout access, admin workflow, background work, deployment, and long-term ownership.
Who this is for
Ecommerce leaders and developers choosing between theme code, Functions, apps, admin extensions, integrations, and headless storefronts.
Shopify Development Guide: Themes, Apps, Functions & Headless
Shopify gives you four places to write code. Picking the wrong one is the single most expensive mistake we see on audits. Here's how we decide.
Themes (Liquid + Online Store 2.0)
- Use for: storefront UI, content, merchandising, anything tied to a page.
- Strengths: Fast to ship, native performance, marketing can edit sections without devs.
- Limits: Can't modify checkout (that's Functions/UI extensions), can't persist custom data structures (that's metafields/metaobjects).
Work with us
Need help applying this to your store?
Shugert has shipped 30+ Shopify builds and migrations since 2016. Book a working session and we'll map the next concrete step for your store.
Shopify Functions (Plus & non-Plus)
- Use for: discount logic, shipping/payment customization, cart and checkout validation, fulfillment routing.
- Strengths: Run inside Shopify's infrastructure, milliseconds, no app server to maintain.
- Limits: Function-specific APIs, sandboxed runtime (Wasm). Not for arbitrary backend logic.
Apps (Remix + Shopify CLI)
- Use for: admin UI, integrations with external systems, async jobs, anything that needs a database or background worker.
- Strengths: Full backend, OAuth, webhooks, billing. Can be private (your store only) or public.
- Limits: Performance overhead, keep storefront-rendered app blocks lean.
Headless (Hydrogen / Next.js + Storefront API)
- Use for: brands with content velocity needs, multi-region/multi-store complexity, sub-1.5s LCP requirements.
- Strengths: Total UI freedom, edge caching, better DX for senior frontend teams.
- Limits: You re-implement what theme gives you for free. Not a fit for most brands under $5M.
Quick decision tree
- "I need to change a PDP" → theme section.
- "I need a discount no app supports" → Shopify Function.
- "I need to sync inventory with my ERP" → app (private) or middleware.
- "I need 100% control over storefront UI" → headless (only if you can staff it).
We build across all four layers for Shopify and Shopify Plus brands. Get a quote.
By early 2026, the Shopify development landscape has fully transitioned away from legacy Ruby-based scripting toward a logic-at-the-edge model. With the final deprecation of Shopify Scripts on August 28, 2025, Shopify Functions have become the universal standard for back-end commerce logic. These WebAssembly (Wasm) modules now handle complex logistics like fulfillment routing and high-volume discount engine modifications, operating at a scale that previously required dedicated middleware. Following a record-breaking 2025 BFCM where Shopify processed over $12 billion in GMV, the emphasis for developers has moved from "building features" to "optimizing latency," particularly as Checkout Extensibility reaches 100% adoption among Plus merchants.
The introduction of the Model Context Protocol (MCP) and agentic commerce features has further expanded the definition of Shopify development. High-growth brands are increasingly utilizing Hydrogen, Shopify’s React-based framework, hosted on Oxygen to build sub-second storefronts that integrate directly with these AI models. Headless is no longer a purely aesthetic choice; it is a performance strategy for brands managing multi-store international footprints. As we move through Q1 2026, the convergence of Metaobjects for structured data and Shopify Functions for logic means that the "Liquid-first" approach is reserved for content orchestration, while the core business engine lives in the Shopify-hosted edge environment.
Frequently asked questions
Are Shopify Scripts still supported in 2026?
Shopify Scripts were officially deprecated on August 28, 2025. All custom cart and checkout logic must now be migrated to Shopify Functions. Unlike Scripts, which were Ruby-based and limited to Shopify Plus, Functions are written in languages like Rust or JavaScript (compiled to Wasm) and offer significantly better performance and reliability during high-traffic events like BFCM.
What is the difference between Hydrogen and Oxygen?
Hydrogen is Shopify's preferred framework for headless commerce, built on Remix and optimized for the Storefront API. Oxygen is Shopify's global hosting platform for Hydrogen storefronts. Together, they eliminate the need for third-party hosting (like Vercel) and provide a tighter integration with Shopify’s data layer, reducing the 'headless tax' or the overhead of managing separate infrastructure.
When should I use a Shopify Function instead of a full App?
Shopify Functions are ideal for logic that needs to run within the core checkout flow, such as custom discounts, shipping rates, or validation rules. Apps should be used when you need a persistent database, a custom user interface in the Shopify Admin, or long-running background tasks. If your logic only needs to modify the cart or checkout behavior without extra data storage, a Function is the more performant choice.
What role do Metaobjects play in modern Shopify development?
Metaobjects allow developers to define custom data structures (like 'Designer Profiles' or 'Technical Specs') directly in Shopify. They are more powerful than Metafields because they can be managed as distinct entities with multiple fields and can be linked to products, collections, or customers. They are the standard for managing complex content without needing an external Headless CMS.
Further reading
Related Shugert resources
- Shopify Functions in depth, what they replace and how to migrate
- Building a product recommender without an app using Liquid
- Five places where custom development beats off-the-shelf
- How AI builders like Lovable and v0 compare to custom dev
- Talk to our development team.
Additional references
<!-- phase-3-priority-content:development-pillar -->Shopify development architecture map
Shopify development is the discipline of placing each requirement on the smallest supported surface that can own it safely. Start with the data and execution contract. Then choose theme code, an app, Shopify Functions, an admin extension, an integration, or a headless storefront.
| Requirement | Default surface to evaluate | Key ownership question |
|---|---|---|
| Storefront presentation | Theme section, block, snippet, or app block | Can a merchant edit it without a deploy? |
| Checkout business logic | Shopify Functions or a supported checkout extension | Is the behavior supported for the plan and market? |
| Merchant workflow | Admin extension or embedded app | Who owns permissions, retries, and support? |
| Background synchronization | App service, queue, and webhook processing | How are idempotency and reconciliation proved? |
| External system integration | Stable API contract plus monitoring | What happens when either system is unavailable? |
| Highly custom presentation | Headless only when its operating cost is justified | Can the team own hosting, caching, preview, SEO, and releases? |
How should a requirement be specified?
Write inputs, outputs, business rules, permissions, volume, latency, failure states, audit needs, and the person accountable after launch. A feature without an operating owner is unfinished even when the code works.
What should a technical review reject?
Reject duplicate sources of truth, hidden theme dependencies, undocumented elevated permissions, synchronous work that should be queued, unbounded API retries, and checkout assumptions that are not supported by current documentation.
Use the custom development vs apps scorecard for build-or-buy and the Shopify expert vetting checklist when one specialist will own the implementation.
Verified primary sources
Documentation used to validate this guide
Platform capabilities, dates, and technical recommendations should be checked against first-party documentation. These links leave Shugert and open the original source.
Recommended path
From learning to an executable decision.
This resource belongs to the Custom Build or Replatform journey. Use the pillar guide for the complete framework, review the relevant capability, and request a scope when the issue requires implementation.
Read the pillar guide
Custom build and replatform guide
Review the relevant capability
Shopify Development
Custom Build or Replatform
A bounded project for themes, migrations, apps, integrations, B2B, and architecture changes.
Keep reading
Related resources
Continue with a guide from the same operating system, not a generic recommendation.