Custom Liquid
What it does
Section titled “What it does”Custom Liquid adds merchant-provided custom content to a template. It is different from Custom section, which is a container for theme content blocks.
Add it to a page
Section titled “Add it to a page”- Open the theme editor from Online Store → Themes.
- Choose the template you want to edit.
- Select Add section → Custom Liquid.
- Enter your content in Custom Liquid, then save.
Set it up: quick start
Section titled “Set it up: quick start”- Duplicate your theme before adding custom code.
- Add Custom Liquid to the copied theme.
- Paste only content you understand and know how to support.
- Keep Full width off and both spacing values at 32 px to begin.
- Preview the result on desktop and phone before publishing your theme.
Settings
Section titled “Settings”| Setting | Default | Options | What it does |
|---|---|---|---|
| Custom Liquid | Empty | Custom content | Content to render; empty content is hidden |
| Full width | Off | On / Off | Span the page width instead of the normal content column |
| Space above content | 32 px | 0–120 px; step 8 | Space before the content |
| Bottom spacing | 32 px | 0–120 px; step 8 | Space after the content |
Images and content tips
Section titled “Images and content tips”Use accessible headings, meaningful image alternatives, and content that fits a phone screen. A section cannot make arbitrary third-party code accessible or fast automatically.
Good to know
Section titled “Good to know”- Empty content is hidden in both the editor and storefront. Select the section in the sidebar to enter content.
- A same-named content block is available in compatible theme-block containers. Product and Featured product also have their own Custom Liquid blocks; use the entry for the area you want to change.
- Theme support does not automatically include third-party customizations. Confirm support with the code provider and ask a Shopify Partner for help when needed.
- Avoid putting private credentials in theme content. Anything displayed or delivered to the storefront can be read by visitors.
Example setups
Section titled “Example setups”Content within the page: keep Full width off and both spacing values at 32 px. Use this for a small custom information area.
Full-width content: turn Full width on and set both spacing values to 0 px when your custom content supplies its own spacing. Check the content itself on phones.
Common questions
Section titled “Common questions”Why is the section invisible? The content is empty. Add the content in the sidebar; the theme does not create a visible placeholder.
Will this install an app? No. Follow the app’s installation instructions and use an App block when the app provides one.
Will third-party code work automatically? Compatibility depends on that code. Test it in a copied theme and confirm its support arrangements.