Add a Custom Liquid section or block
Insert your own HTML, Liquid or a third-party embed code on any page, without editing theme files.
Support status: The Custom Liquid section and the Custom Liquid blocks are part of Lintel and are supported. The code you paste into them is your own; we can't write, debug or maintain it. For complex features, hire a Shopify Partner.
Duplicate your theme first. In Online Store > Themes, select ⋯ > Duplicate and test your code on the copy. Broken HTML in a Custom Liquid field can break the layout of the page it's on.
Where you can add custom Liquid
- Custom Liquid section: add it to any page with Add section > Custom Liquid. It has one setting, Liquid.
- Custom Liquid block: available in the Product, Featured product, Collection, Cart and Article sections, so you can place code between other blocks, for example under the add to cart button.
Add a Custom Liquid section
- In the theme editor, open the page where you want the code.
- Select Add section and choose Custom Liquid.
- Paste your code in the Liquid field.
- Drag the section to where you want it, then select Save.
Example: a shipping message on product pages
In a product template, add a Custom Liquid block to the Product section and paste:
{% if product.tags contains 'made-to-order' %}
<p>Made to order. Ships in 4–6 weeks.</p>
{% endif %}
Tag your made-to-order products with made-to-order, and the message appears only on those products.
Example: embed a third-party widget
Paste the embed code the service gives you (for example a booking or chat widget) into a Custom Liquid section. If the service offers a Shopify app with app blocks, prefer the app: app blocks are easier to manage and are removed cleanly when you uninstall the app.
Good practice
- Keep the code short. Larger features belong in an app or a custom section built by a developer.
- Write text in your own words, and add
alttext to any image. - Don’t load scripts you don’t trust; they run on every visit to that page.
- After a theme update, check pages with custom code.