Skip to content

Powered by

Shopify Premier Partner
Let's talk

What Is Shopify Liquid and How to Learn It in 2026

Red-haired woman sipping a drink while smiling at a MacBook, with a camera on the table, learning Shopify Liquid

Summarize with AI

Liquid is the template language behind every Shopify theme. This guide covers the syntax, where Liquid sits in today's themes, Shopify CLI and Theme Check, AI tools such as Sidekick block generation and the Shopify AI Toolkit, the 2026 changes that make Liquid themes agent-friendly (AGENTS.md, block and partial tags, Tailwind joining Shopify), and the learning resources that are still current in November 2026.

Liquid is the template language that every Shopify theme is written in. If you want to change more than the theme editor's settings allow, build a custom feature or develop a theme from scratch, you'll work with Liquid. This guide explains what Liquid is, how it fits into today's Shopify themes, how AI tools now help write it, what Shopify is changing in Liquid for AI agents, and which learning resources are still worth your time. We checked every tool, feature and link below against Shopify's documentation on November 6, 2026.

What is Shopify Liquid?

Liquid is a template language created by Shopify. It loads your store's data into the pages of your theme: product titles, prices, images, collections, blog posts, cart contents and anything else that comes from your Shopify admin.

Liquid is open source and written in Ruby. Shopify's storefronts use an extended version of it with Shopify-specific objects, tags and filters, documented in the Liquid reference on shopify.dev. Other platforms use open-source Liquid too, so the basic syntax you learn for Shopify carries over.

You don't have to know Liquid to run a Shopify store. Themes from the Shopify Theme Store let you change layouts, colors and content in the theme editor without code. You need Liquid when you want something the theme's settings don't offer.

Static vs. dynamic content

A Shopify theme mixes static HTML with dynamic Liquid. Static elements, such as a fixed piece of markup in the footer, look the same on every page. Dynamic content depends on what's in your admin, such as product details, prices and stock, and Liquid fills it in when a page loads.

Say a shopper goes through your product pages one by one. Every time a new page loads, Shopify replaces the Liquid in your product template with that product's data. The template stays the same, and the content changes.

Liquid syntax basics: objects, tags and filters

Liquid code is built from three pieces: objects, tags and filters.

  • Objects hold your store's data, such as a product, a collection, the cart or a blog article. You print them with double curly braces, for example {{ product.title }}.
  • Tags add logic: conditions, loops and variables. They sit between curly braces and percent signs, {% %}, and don't print anything themselves.
  • Filters change how output looks. You add them after a pipe character, for example {{ product.price | money }} formats a price in your store's currency.

Here's a short example that shows a product's price or a "Sold out" message:

{% if product.available %}
  <p>{{ product.title }}: {{ product.price | money }}</p>
{% else %}
  <p>{{ product.title }} is sold out</p>
{% endif %}

In short:

  • .liquid: the file extension of Liquid files
  • {{ }}: output (objects, usually with filters)
  • {% %}: logic (tags such as if, for and assign)

Where Liquid sits in a Shopify theme today

A modern Shopify theme is a set of folders, and Liquid lives in most of them. Since Online Store 2.0, page templates are usually JSON files that only list which sections appear on a page and in what order. The Liquid code sits in sections, blocks and snippets, which merchants can then add, remove and rearrange in the theme editor.

FolderWhat it holdsLiquid?
layoutThe base of the theme, such as theme.liquid, with elements repeated on every pageYes
templatesOne template per page type; JSON templates only list sections, Liquid templates contain codeJSON or Liquid
sectionsModules merchants add to pages, plus section groups for areas such as the header and footerYes (groups are JSON)
blocksTheme blocks: reusable modules that can be used across sections and nested inside each otherYes
snippetsReusable pieces of Liquid, included with the render tag and not visible in the theme editorYes
configTheme settings and their saved valuesNo (JSON)
localesTranslations for the storefront and the theme editorNo (JSON)
assetsCSS, JavaScript and imagesOptional

Source: Shopify theme architecture, checked November 6, 2026.

Theme blocks and Horizon

Theme blocks are the biggest change to Liquid themes since Online Store 2.0. They live in the theme's blocks folder and, unlike older blocks defined inside one section, can be reused across sections and nested inside each other (Shopify docs).

Horizon, which Shopify introduced in the Summer '25 Edition in May 2025, is the family of free Shopify themes built around theme blocks. Its source code is public in Shopify's Horizon repository, which makes it a good place to see how Shopify itself writes Liquid today. Dawn, the Online Store 2.0 reference theme from 2021, is still around, but new Shopify themes follow the Horizon approach. Our guide to customizing a Shopify theme covers choosing and editing themes without code.

What Liquid no longer does: checkout

You can't customize Shopify's checkout pages with Liquid anymore. The checkout.liquid file stopped working for the Information, Shipping and Payment pages on August 13, 2024, and checkout changes now go through Checkout Extensibility: apps, extensions and the checkout editor. If your store still has old checkout code, read our Checkout Extensibility upgrade guide.

How to open and edit Liquid code in Shopify

You edit Liquid in the code editor in your Shopify admin. Go to Online Store > Themes, click the … button next to the theme you want to change and choose Edit code.

You'll see the theme's folders and files. Files with the .liquid extension contain HTML mixed with Liquid, and you can tell the two apart by Liquid's delimiters: {{ }} and {% %}.

Before you change anything, keep these rules in mind:

  • Duplicate the theme first. Shopify recommends a backup copy, and deleting files can break a theme.
  • Edit a copy, not the live theme. Preview the duplicate, then publish it when it works.
  • Use the file history carefully. Each file has a Timeline view for restoring earlier versions, but restoring replaces the whole file, the history is limited, and files in the assets folder don't have it.
  • Paid themes need a license. You have to buy a Theme Store theme before you can edit its code.

Working locally with Shopify CLI and Theme Check

For anything bigger than a small fix, developers work on Liquid locally with Shopify CLI. The admin code editor is fine for a quick change, but it has no version control and no code review. Shopify CLI connects a local copy of the theme, usually kept in Git, to your store. The commands you'll use most:

  • shopify theme dev uploads your local theme as a development theme so you can preview changes before anyone sees them.
  • shopify theme pull and shopify theme push download and upload theme files.
  • shopify theme check runs Theme Check, Shopify's linter, which catches Liquid errors and code that breaks theme best practices.
  • shopify theme console opens a Liquid REPL for testing snippets of code against your store.
  • shopify theme profile profiles the Liquid on a page, which helps find slow code.

If you use VS Code, the Shopify Liquid extension adds syntax highlighting, autocompletion, inline documentation and Theme Check as you type. For snippets and blocks, LiquidDoc lets you document parameters in a {% doc %} tag, and Theme Check then warns you when a required parameter is missing.

Writing and reviewing Liquid with AI

AI can now write a lot of Liquid, both inside Shopify and in a developer's editor, but someone still has to review and test the result. Shopify says this itself in the documentation for both of its AI tools.

AI block generation in the theme editor

Merchants can generate new theme blocks by describing them to Sidekick, Shopify's AI assistant, in the theme editor. The feature launched with Horizon in May 2025, and since December 10, 2025 it works with every theme from the Shopify Theme Store (Shopify changelog). According to the Shopify Help Center:

  • the generated block is a new Liquid file in your theme's blocks folder, and it can also contain HTML, CSS, JSON and JavaScript;
  • it isn't available on the Starter plan, on vintage themes, or on paid themes you haven't bought yet;
  • only the store owner, administrators and staff with the Edit Code permission can generate blocks;
  • Shopify says AI-generated code may not always be perfect and that you're responsible for reviewing and testing it;
  • Shopify Support doesn't help customize or troubleshoot AI-generated block code.

For a simple banner or content block, this is a quick way to get started. For anything that touches store logic, product data or performance, treat the generated file like code from a new developer and have someone check it.

Shopify AI Toolkit and Dev MCP for developers

Developers can connect coding agents to Shopify's documentation and validators with the Shopify AI Toolkit. It works with Claude Code, Codex, Cursor, VS Code and other agents, installs as a plugin or agent skill, and includes the Dev MCP server (@shopify/dev-mcp), which runs locally. Among other things, it validates Liquid templates against Shopify's schemas, so the agent checks its code against current docs instead of relying on what it remembers. Shopify notes that the toolkit doesn't remove the need to review and test the result. We explain the wider picture in Shopify MCP explained.

How to use AI on Liquid safely

AI works on Liquid when it works inside a process, not instead of one. Liquid has no static types, so an agent's mistakes don't show up at build time the way they do in a TypeScript project, such as a Hydrogen storefront. Wrong object names, missing translations or a loop that slows down a collection page can look fine until a shopper hits them. That's why the checks around the agent matter more than the agent itself. In our projects:

  • The agent works on a copy. It edits a local theme in Git or a development theme, never the live one.
  • It works from Shopify's current docs. We connect it to the AI Toolkit and Dev MCP, so it checks objects, filters and schemas against the reference.
  • Every change passes Theme Check before a person looks at it.
  • A developer reviews and signs off. Someone from our team reads the diff, tests the page on desktop and mobile, checks speed, and only then publishes.

In 2026, AI agents let us build even complex custom features in Liquid much faster than a few years ago. What hasn't changed is who answers for the result: a developer on our team owns the quality of every change that goes live.

How Shopify is making Liquid agent-friendly

In 2026 Shopify started changing Liquid themes so that coding agents, including its own Sidekick, can read and edit them more reliably. Some of these changes are already available and some are still in preview, so check their status on shopify.dev before you build on them. Here's where they stood on November 6, 2026.

AGENTS.md and DESIGN.md: instructions for agents inside the theme

A theme can now carry its own instructions for AI agents in two optional Markdown files at its root. According to Shopify's docs on agentic workflows for themes:

  • AGENTS.md explains how the theme is built: its architecture, conventions and the patterns it deliberately avoids.
  • DESIGN.md records the theme's design intent, so an agent can extend the design consistently.
  • Sidekick reads both files before it changes a theme in Canvas, Shopify's new store editor (in early access), and it can update DESIGN.md when a merchant asks for a stylistic change.
  • Local coding agents that support the AGENTS.md format read the same files as project instructions.
  • Shopify CLI 4.8.4 and higher includes both files in shopify theme pull, push and package, and each file can be up to 50 KB.
  • Shopify doesn't render these files, and shoppers never see them.

For a developer, this means the conventions you'd explain to a new team member now live in the theme itself and travel with it. Sidekick in the admin and the agent on your laptop work from the same rules.

The block and partial tags: page structure in one Liquid file

Shopify is adding two Liquid tags that let a template build a whole page from blocks. It announced them on July 21, 2026 as the Liquid July '26 developer preview (Shopify changelog):

  • {% block %} renders a reusable theme block directly from a template, the way {% render %} renders a snippet.
  • {% partial %} marks a region of server-rendered HTML that JavaScript can refresh without reloading the page, such as a product grid after filtering.

Shopify's stated reason is that with page structure in the template, developers and coding agents can read and edit everything in one place, instead of piecing a page together from a JSON template and a tree of sections. Existing themes keep working with sections, theme settings and JSON templates, and the preview added new Theme Check rules for these Liquid-first themes.

In the Fall '26 Edition on October 28, 2026, Shopify presented this as its new theme architecture: pages composed in Liquid with blocks, typed contracts and partial updates, markdown files to guide agents, and Tailwind styling built in. Shopify also says Canvas is built on this architecture. The Skeleton theme shows what it looks like in practice: no sections and no JSON templates, a {% doc %} header on every block, and a README that says the theme is designed to be edited by coding agents as readily as by people. The same README notes that the partial tag still depends on a feature that isn't enabled on every store.

A stricter Liquid parser

Since January 13, 2026, Liquid rejects some code that older versions accepted but evaluated incorrectly. For example, a logical expression in an assign tag, such as assign x = false or true, used to be silently evaluated wrong and now fails to parse. Shopify updated affected theme files automatically and left comments explaining the changes (changelog). Shopify says the stricter mode will let it support these patterns properly in the future (migration guide). For anyone writing Liquid, human or agent, the practical effect is that mistakes now show up as errors instead of wrong output.

Tailwind CSS is now part of Shopify

On September 9, 2026, Tailwind Labs, the company behind the Tailwind CSS framework, announced that it is joining Shopify. Founder Adam Wathan described it as "joining" in the Tailwind blog post, and Shopify's law firm Osler lists the deal as Shopify's acquisition of Tailwind Labs. The terms weren't disclosed.

  • Tailwind CSS stays open source. It and Tailwind Labs' other open-source projects remain under the MIT license, and the Tailwind team keeps maintaining them with Shopify's support.
  • The paid products stop growing. Existing customers keep access to Tailwind Plus and ui.sh, but new sign-ups are closed.
  • The reasons Wathan gives: a stable long-term home for the framework, developing it "in service of a real product", the fact that Tailwind is already a load-bearing part of Shopify's stack, and Shopify's work on agentic commerce.

For Liquid theme developers, the connection is the Fall '26 announcement of Tailwind styling built into the new theme architecture. On November 6, 2026, we didn't find shopify.dev documentation that explains how it will work. Until there is, Tailwind in a Liquid theme remains a build step: Shopify's file transformation guide lists it among PostCSS tools that compile into the CSS your theme ships. Our reading of why this matters for AI: with utility classes, a block's markup and styling sit in the same file, which fits the one-file-per-block model that agents now work with.

From our practice: OPTISOFA went back to Liquid

A Liquid theme can handle more than many brands expect, and one of our own clients shows it. In 2023 we built a headless Shopify storefront for OPTISOFA, a Polish furniture brand. When a redesign was due, the store went back to a custom Liquid theme: we designed and built the new store in 2025, and it launched in 2026.

The reasons, as we described them in our headless Shopify examples:

  • Operational speed mattered more than raw speed. On a theme, the team can change the store, install apps and test new ideas without a developer building each one into a custom front end.
  • The headless front end was somewhat faster, but not by enough to outweigh how much slower day-to-day changes were.
  • No feature required headless. Everything they wanted could be built on Liquid, including the 3D configurators: the store kept its Mimeeq integration and moved its modular sofa configurator to The Planner Studio.

My partner Kamil Frejlich and I talked through the same trade-off in our podcast episode Headless Shopify: pros and cons (in Polish, with an English translation). In it, I called Liquid relatively easy to learn, and Kamil pointed out that a Liquid store depends less on developers, who are needed mainly when you want to go beyond what Shopify offers out of the box. If you're still deciding, read when headless Shopify makes sense.

Where to learn Shopify Liquid in 2026

Shopify's own documentation is the best place to learn Liquid, because it's the only source that's always current. Here's what we'd recommend, checked on November 6, 2026:

A few resources that older guides, including the earlier version of this article, recommended are no longer worth using. Shopify Academy's Liquid courses now redirect to the shopify.dev docs, so there's no separate official course to sign up for. We've also removed several third-party cheat sheets and tutorials that were offline or written for themes from before Online Store 2.0.

Need help with Liquid?

For small changes, the theme editor, AI block generation and Shopify's docs are often enough. When a change touches store logic, integrations or performance, it's worth having a developer who knows Liquid review it, whether the code was written by a person or an AI agent.

That's what our Shopify theme development team does: we design and build custom Liquid themes and features, with AI agents doing part of the work inside our process and a developer signing off every change. If you're planning a theme project, get in touch.

Author

Matt Czerniak

Co-founder at wecanfly | E-commerce & Shopify expert

Follow on LinkedIn

Let's start with a conversation

The ideal first step would be a short conversation during which you tell us about the challenge you are facing.

Black and white portrait of a young man with shoulder-length hair and a mustache, wearing a plaid shirt over a white t-shirt, against a background with plants and a grid wall.

Adam Choromański

New Business Manager