Shopify platform
Online Store 2.0
OS 2.0
Online Store 2.0 is the 2021 overhaul of Shopify's theme architecture. It introduced sections on every page (not just the homepage), JSON templates, app blocks that merchants can position without editing code, and a much richer metafields system. A theme built before OS 2.0 cannot use these features, which is a common reason to rebuild rather than patch.
Why it matters
The change OS 2.0 made was not cosmetic — it moved control of page structure from developers to merchants. Before it, only the homepage was built from rearrangeable sections; every other page type was a fixed Liquid template. Adding a testimonial block to a product page meant a developer, a deploy, and a wait.
After it, a marketing team can restructure any page type in the theme editor. Over a year, that is the difference between a store that iterates weekly and one that iterates when there is budget.
The second change was to data. The richer metafields system that arrived with OS 2.0 is what made Shopify usable as a light content platform, and it is the foundation everything since — metaobjects, app blocks, the whole custom data model — has been built on.
How it works on Shopify
Three pieces do the work. JSON templates replace fixed Liquid templates: a product template becomes a list of which sections to render and in what order, with their settings. Sections everywhere means those sections can appear on any page type, not just the homepage. App blocks let an app expose a widget the merchant positions themselves, instead of the app injecting code into theme files.
Underneath sits the metafield system: definitions with types and validation, editable in the admin, readable from Liquid and the Storefront API.
A theme built before this architecture cannot use any of it. There is no upgrade path from a pre-2.0 theme — the template model is different at the root — which is why a store still running one is choosing between a rebuild and permanent limitation.
Common mistakes
- Assuming a theme update grants it. Installing a newer version of an old theme does not convert it. The theme has to be built on the 2.0 architecture.
- Building sections that are too large. A section with forty settings is a page, not a component. Merchants cannot compose with it, which defeats the point.
- Ignoring app blocks. Accepting apps that inject code into theme files, when an app block exists, reintroduces exactly the mess 2.0 was meant to end.
- Not defining metafields properly. Values written without definitions are invisible in the admin and unusable in the editor.
- Leaving JSON templates unversioned. Merchant edits in the theme editor change the template files. Without git, those changes are invisible until something breaks.
When you need help
The clear case is a store still on a pre-2.0 theme. That is a rebuild decision, and it deserves a real assessment: what the current theme costs the team in blocked requests each month, against the cost of rebuilding on the current architecture.
The subtler case is a 2.0 theme that is not actually using 2.0 — sections locked down so tightly that merchants still cannot change anything, or a custom data model that never got designed. The architecture is there and the benefit is not, which is a cheaper problem to fix than a rebuild but needs someone to name it first.
Need this done on your store?
Shopify designRelated terms
- Sections and blocksSections and blocks are the units of a Shopify theme that merchants can rearrange in the theme editor without touching code. A section is a self-contained region of a page — a hero, a product grid — and blocks are the repeatable items inside it. Designing a theme as well-scoped sections is what makes a store editable by a marketing team instead of a developer.
- MetafieldsMetafields are custom fields that extend Shopify's built-in resources — products, variants, collections, customers, orders — with data the platform does not model natively. A typical use is a product's care instructions, size chart, or ingredient list. Metafields are typed, can be edited in the admin, and are readable from Liquid and the Storefront API.
- Shopify themeA Shopify theme is the bundle of Liquid templates, sections, CSS, JavaScript, and settings that controls how a storefront looks and behaves. Themes are versioned separately from store data, so you can duplicate one, edit it safely, and publish when ready. Dawn is Shopify's free reference theme and the baseline most custom builds start from.