Liquid

Liquid is an open-source template language developed by Shopify to generate dynamic content in ecommerce stores and websites. You write Liquid code in HTML templates, using tags, objects and filters to retrieve and display data from a database. Think of product names, prices, stock status or customer data. Liquid runs server-side, meaning the code is executed before the HTML is sent to the browser. For SMB ecommerce stores, Liquid is the standard way to customize Shopify themes without touching core functionality.

How Liquid code works in practice

Liquid uses three types of syntax elements. First, objects, written between double braces such as {{ product.title }}, which retrieve and display data from your database. Second, tags, written between brace percents such as {% if product.available %}}, which handle logic and control structures. Third, filters, written with a pipe symbol such as {{ product.price | money }}, which transform or format data. You combine these elements in .liquid files within your theme structure. A typical product page contains dozens of Liquid lines that together provide price display, variant selection, add-to-cart functionality and stock notifications. Shopify's official Liquid documentation describes all available objects and filters.

Why Shopify Liquid Developed

Before 2006, ecommerce store platforms often used PHP or other server-side languages directly in templates, which posed security risks when merchants customized code themselves. Shopify wanted to create a secure environment where shop owners could modify templates without access to server-level code. Liquid provides a restricted, controlled syntax that does not allow direct database access or system commands. This allows even non-developers to make modifications safely. Meanwhile, other platforms such as Jekyll and 11ty also use variants of Liquid, but the Shopify implementation remains the most comprehensive. For Dutch ecommerce stores, this means you can work with one template language for both your Shopify store and any content sites running on Jekyll.

What Liquid brings to ecommerce store owners

With Liquid, you customize the presentation of your ecommerce store without touching the underlying Shopify infrastructure. You can personalize product pages based on collection, customer group or stock status. An example: a sports store displays running shoes differently from cycling shoes by checking for product tags in Liquid and then loading other content blocks. You keep all Shopify updates and security patches because you only change the presentation layer. For SMBs having an ecommerce store design or expansion, Liquid means developers can quickly add custom functionality without building a full custom platform. The code remains readable and portable, which is important if you switch agencies later. Additionally, integrate with API links by combining Liquid with JavaScript for real-time data such as delivery times or dynamic pricing.

Liquid comes into play in virtually every customization of a Shopify ecommerce store, from small text changes to complex product configurators. Below you'll see the most common scenarios in which SMB ecommerce stores use Liquid, including situations where alternatives are a better fit.

Dynamic product pages by collection or category

You use Liquid to automatically customize product pages based on the collection a product is in. For example, a furniture store displays size charts and assembly instructions for cabinets, but delivery time and color variations for chairs. Instead of manually adding content for each product, write one Liquid template that checks on product.collections and then loads the appropriate content blocks. This saves hours of manual work for ecommerce stores with hundreds of products. You define the logic once and Shopify applies it to all relevant products. A common mistake is using too many nested if statements, which makes the code unreadable. Better to work with Liquid-snippets that you load per product type, so that the main template remains clear.

Customer-specific pricing and content via Liquid logic

Wholesale and B2B ecommerce stores often show different prices to logged-in customers versus visitors. With Liquid, you check {% if customer.tags contains 'wholesale' %} and show custom prices, bulk discounts or net amounts. You can even hide entire product categories from unauthorized visitors. For example, an installation company hides professional tools from consumers and shows them only to customers with the tag 'professional'. Liquid retrieves customer data from the Shopify customer object, so you don't need an external database. Note that complex discount structures with more than three customer levels become cluttered in Liquid. Then a Shopify app such as Bold Custom Pricing or a headless architecture with API integration is more effective. Liquid works best for two to three customer segments with distinctly different price lists.

Multilingual ecommerce stores with Liquid-local filters

Shopify Markets and multilingual themes use Liquid filters such as {{ 'general.search.title' | t }} to load translations from locale files. You manage all text centrally in JSON files per language, and Liquid automatically selects the correct version based on the customer’s locale. An ecommerce store serving both the United States and Flanders displays “winkelwagen” versus “winkelmandje” without having to maintain duplicate templates. This also works for date formats, currencies, and units of measurement. You write the Liquid template once and add translations via the theme admin panel. For ecommerce stores with more than five languages, managing locale files becomes complex. In that case, a translation app like Weglot or Langify is more convenient, as it also automatically translates dynamic content such as product descriptions. Liquid locale filters are ideal for static UI text in two to four languages.

When Liquid is the right choice and when it is not

Use Liquid if you want to stay within the Shopify environment and need to make adjustments to presentation, logic, or content display. It is the standard for theme development and is supported by all Shopify apps and updates. Do not choose Liquid if you need complex real-time calculations (such as shipping costs based on external APIs), because Liquid runs server-side and does not support asynchronous calls. For highly dynamic interfaces with a lot of interaction, a JavaScript framework such as React or Vue is also more effective, possibly in a headless setup. Liquid combines well with custom front-end development for hybrid solutions in which Liquid handles the basic rendering and JavaScript handles the interactive layer.