Custom Liquid

Overview

The Custom Liquid block allows you to add custom Liquid/HTML content directly in the Theme Editor.
This is useful for advanced customization, embedding snippets, or adding custom markup without editing theme files.

---

Where to use this block

You can add Custom Liquid anywhere theme blocks are supported, for example:

• Content sections

• FAQ / help pages

• Product or collection pages (when supported)

• Any layout where you need custom markup

---

How to add this block

1. Open the Theme Editor

2. Navigate to a section that supports blocks

3. Click Add block

4. Select Custom Liquid

5. Paste your Liquid/HTML into the editor field

---

Block settings

Content

• Custom liquid
  Paste your custom Liquid/HTML code here.
  The output is rendered on the storefront.

---

Layout & behavior

Under Size, you can control block width per device:

• Width (Desktop)
  Fit content / Fill / Custom

• Custom width (Desktop) (visible when Width = Custom)
  Sets the width as a percentage (0–100%).

• Width (Tablet)
  Fit content / Fill / Custom

• Custom width (Tablet) (visible when Width = Custom)
  Sets the width as a percentage (0–100%).

• Width (Mobile)
  Fit content / Fill / Custom

• Custom width (Mobile) (visible when Width = Custom)
  Sets the width as a percentage (0–100%).

---

Style

Under Borders:

• Border style
  None / Solid / Dashed

• Thickness (visible when Border style is not None)
  Border thickness in pixels.

• Border opacity (visible when Border style is not None)
  Controls border transparency.

• Border radius
  Rounds the block corners.

---

Padding

Controls the spacing inside the block:

• Top

• Bottom

• Left

• Right

---

Tips

• Use Custom Liquid for small, targeted customizations rather than large layouts

• Keep your code simple and test changes using the live preview

• Use device-specific width settings to ensure the layout looks good on mobile and tablet

---

Limitations

• Custom Liquid output depends on the Liquid/HTML you paste. Incorrect code can break layout or display unexpected results.

• Avoid adding large or complex scripts inside Custom Liquid unless you know exactly what they do and how they impact performance.

---

Common use cases

• Embed custom HTML blocks (badges, trust messages, custom layout)

• Add small Liquid snippets (dynamic values, conditional content)

• Add lightweight embeds (when supported by the content)

---

Need help?

If the output is not displaying correctly, check your Liquid/HTML for syntax issues and test on desktop, tablet, and mobile before saving.