The Custom Liquid element lets you run Shopify Liquid code inside an Instant layout. Reach for it when the visual builder and Instant's Shopify data tools can't express what you need — a theme snippet, custom metafield formatting, or logic beyond standard elements. Custom Liquid is available on the Starter plan and above.

Try Instant's built-in bindings first. Dynamic text and images, Repeat element, Conditional visibility, and metafields all work in the builder without any code. See Dynamic text, Use metafields, and Repeat elements over data.

Add a Custom Liquid element when you need something those tools don't cover — for example a Liquid snippet from your existing theme, a bespoke price or inventory message, or a Shopify object that has no dynamic source in the Design panel.

The element appears as a Code block layer in the Layouts & layers panel.

Select the code block and open the Custom Liquid code section in the Design panel:

Instant renders your Liquid through your connected Shopify store, so the preview reflects Shopify's own output. If your Liquid has a syntax error, the editor surfaces it so you can fix it before publishing.

The editor needs a connected Shopify store — connect one first if your project isn't linked yet (see Connect your Shopify store).

If your store is password-protected, the section shows Store password required with the message Custom Liquid code requires your store password to be configured. Click Configure to add it under Settings → Shopify. See Password-protected stores.

Custom Liquid requires the Starter plan or higher. On Free, the Custom Liquid element in Insert shows a Starter badge and can't be added to the canvas. Upgrade under Upgrade your plan.

Higher plans add capabilities unrelated to Liquid itself — for example the cart drawer and publishing to draft themes on Pro and up.