Skip to content

What Is Shopify Online Store 2.0?

Definition

Online Store 2.0 is the Shopify theme architecture, announced in June 2021, that replaced fixed Liquid templates with JSON templates. It lets merchants add sections to almost every page, connect settings to metafields through dynamic sources and add apps as app blocks in the theme editor without editing code. Older themes are called vintage themes.

How Online Store 2.0 works

Before 2021, most Shopify themes built each page type from a single Liquid template. The home page could be assembled from sections, but a product, collection or content page had a fixed layout, and changing it meant asking a developer. Shopify announced Online Store 2.0 at Shopify Unite in June 2021 and moved theme Liquid into JSON templates, so sections became available on more pages than the home page.[1]

A JSON template is a data file that lists the sections a page renders and the settings of each one. Merchants add, remove and reorder those sections in the theme editor, and the editor saves the result back to the JSON file.[2] The markup lives in section files, so the same section can appear on a product page, a landing page and the home page. Every template type except gift_card, robots.txt, agents.md, llms.txt and llms-full.txt can be a JSON template.[2]

Shopify's help center lists what an Online Store 2.0 theme can do that a vintage theme cannot: sections on every page, new templates created from the theme editor, app blocks and app embeds, dynamic sources for resource attributes and metafields, collection filtering and predictive search.[3] Upgrading is not mandatory, and a vintage theme keeps working.[4] But vintage themes are no longer in the Theme Store, and Shopify's free vintage themes receive only security fixes.[3]

The parts of an Online Store 2.0 theme

PartWhat it doesLimit or rule
JSON templatesList the sections and settings for a page type, such as product.jsonUp to 25 sections per template and 50 blocks per section; up to 1,000 JSON templates per theme[2]
Alternate templatesA second layout for a group of products or pages, such as product.preorder.jsonCreated in the theme editor[3]
Section groupsJSON files for areas shared by every page, usually the header and footerUp to 25 sections per group[5]
Dynamic sourcesConnect a section or block setting to a product attribute or a metafieldNot available for global theme settings[6]
App blocksApp content placed inside a section, such as reviews under the product formThe section must render blocks of type @app[7]
App embed blocksApp code with no visible block, such as a chat widget or trackingRendered before </head> or </body>, switched on in Theme settings > App embeds[7]

App blocks are the part that changed apps the most. Apps reach an Online Store 2.0 theme through theme app extensions, and each extension can ship up to 30 blocks, 10 MB of files and 100 KB of Liquid.[7] Because the code lives in the extension and not in the theme files, merchants add the block in the theme editor and uninstalling the app removes its code cleanly.[1] On a vintage theme, apps pasted snippets into theme files, and those snippets were often still there years after the app was gone.

Online Store 2.0 is no longer the newest level. Shopify's comparison table adds theme blocks as a further step that Online Store 2.0 themes do not have.[3] A theme can be fully Online Store 2.0 and still not support theme blocks.

Example: moving a vintage theme to Online Store 2.0

Take a hypothetical fashion store on a custom vintage theme built in 2019, with 1,200 products, 14 Liquid templates and six apps that inject snippets into the theme. The marketing team wants a size guide and a "complete the look" row on product pages and cannot add either without a developer.

  1. Templates. The product, collection, page and index templates are converted to JSON, and their markup moves into sections. The new product template uses 6 sections: gallery, product information, size guide, reviews, complete the look and recommendations. That is 6 of the 25 a JSON template allows.[2]
  2. Alternate template. 40 preorder products get product.preorder.json with a delivery-date section, instead of an if tag buried in one shared template.
  3. Data. The size guide and the related products come from metafields, connected through dynamic sources, so staff edit data in the admin, not HTML in descriptions.[6]
  4. Apps. Each of the six apps is checked for an app block or app embed. The old snippets are deleted from the theme files once the block version is live.

The result is the same design with a different owner: after migration, the marketing team builds landing pages and rearranges product pages in the theme editor, and the developer only builds new sections. Our guide to Online Store 2.0 features for migrated custom themes covers this process in more detail.

Pros and cons of migrating a vintage theme

ProsCons
Sections on every page, editable without codeA custom theme needs a developer to convert templates and sections
Apps install as blocks and uninstall cleanlyEvery app has to be retested and old snippets cleaned up
Metafields shown through dynamic sourcesTemplate customisations hidden in Liquid must be found and rebuilt
Collection filtering and predictive searchA store-wide change that needs a full QA pass before publishing

Online Store 2.0 vs vintage themes

Vintage themeOnline Store 2.0 theme
SectionsHome page onlyEvery page with a JSON template
New templates in the theme editorNoYes
App blocks and app embedsNoYes
Dynamic sources and metafieldsNoYes
Theme Store and updatesNot in the Theme Store; free themes get security fixes onlyCurrent themes are in the Theme Store

Source for the table: Shopify Help Center.[3]

FAQ

How do I know if my theme is Online Store 2.0?

In the theme editor, open Products and then Default product. If an Add section button appears below the section list, your theme supports sections on every page. If it doesn't, you most likely have a vintage theme.[3]

Do I have to upgrade to Online Store 2.0?

No. Shopify says upgrading isn't mandatory and a vintage theme can stay if it meets your needs.[4] But vintage themes aren't in the Theme Store, free ones get only security fixes, and apps increasingly ship as app blocks.[3]

Is Dawn an Online Store 2.0 theme?

Yes. Shopify introduced Dawn at Unite 2021, together with Online Store 2.0, as its first open-source reference theme, and announced that it would replace Debut as the default theme for new stores.[1]

Can I migrate a vintage theme myself?

You can, either by installing a newer version of the theme or by migrating manually. Manual migration means converting Liquid templates to JSON and moving markup into sections, which needs Liquid, HTML, CSS and JavaScript.[4]

What is the difference between an app block and an app embed?

An app block shows content inside a section, such as reviews under the product form. An app embed adds code with no visible block, such as a chat widget, and is switched on in Theme settings under App embeds.[7]

The bottom line

Online Store 2.0 is the theme architecture Shopify has used since 2021: pages are JSON lists of sections, so merchants arrange them in the theme editor instead of asking for code changes. It also brought app blocks, dynamic sources and metafields into the theme. A vintage theme still works, but it is frozen, and every year more apps and features assume Online Store 2.0. If your custom theme needs migrating, our Shopify theme development team can convert it without changing the design.

Article sources

We use primary sources only: official documentation, product pages and laws. Each link was checked on the date shown.

  1. Shopify Partners Blog. Shopify Unite 2021 announcements. Accessed 17th Nov 2026.
  2. Shopify Dev. JSON templates. Accessed 17th Nov 2026.
  3. Shopify Help Center. Theme architecture versions. Accessed 17th Nov 2026.
  4. Shopify Dev. Online Store 2.0. Accessed 17th Nov 2026.
  5. Shopify Dev. Section groups. Accessed 17th Nov 2026.
  6. Shopify Dev. Dynamic sources. Accessed 17th Nov 2026.
  7. Shopify Dev. Configure theme app extensions. Accessed 17th Nov 2026.

Need this on your store?

See the service

The checklist we run before touching a client's code

Get it by email, plus a few short notes over the next two weeks: what we see most often on Shopify stores and what actually fixes it.

No spam. Unsubscribe anytime. Privacy Policy