Custom Liquid

Custom Liquid

Start your free trial
Start your free trial

General

Online store speed
Online store speed
Accessibility
Accessibility
Theme updates
Theme updates

Theme styles

Style presets
Style presets
Colors
Colors
Fonts
Fonts
Animation
Animation
Social media
Social media

Header

Announcement bar
Announcement bar
Mobile menu
Mobile menu
Search bar
Search bar

Sections

Products

Product listings
Product listings
Product badges
Product badges
Quick view
Quick view
Quick add
Quick add

Product page

Product template
Product template
Variant chips
Variant chips
Sticky add-to-cart bar
Sticky add-to-cart bar
Sibling product swatches
Sibling product swatches
Product recommendations
Product recommendations

Collection page

Collections template
Collections template
Banner
Banner
Product grid
Product grid
Filters and sorting
Filters and sorting

Cart

Quick cart
Quick cart
Cart page
Cart page
Added-to-cart popup
Added-to-cart popup
Cross sells
Cross sells
Free shipping bar
Free shipping bar
Low inventory warning
Low inventory warning

Pages

Templates
Templates
Home page
Home page
About page
About page
Blogs page
Blogs page
Blog post
Blog post
Collections list
Collections list
Contact page
Contact page
Password page
Password page
Search page
Search page
404 page
404 page

Support

Support policy
Support policy
Shopify vs Theme issues
Shopify vs Theme issues
Store access requests
Store access requests

Advanced: Custom Liquid

Note | We do not support code customizations. This guide offers a basic reference for developers and advanced users. Always test code changes on an unpublished copy of your theme. For assistance, we recommend finding a professional developer through Shopify Experts or Task Husky.

With the Custom Liquid setting, you can extend your theme by adding snippets of Liquid or HTML code as a block or section in the theme editor.

Custom Liquid provides a reliable and safer option compared to directly editing your theme code. It will help keep your theme copy eligible for updates and avoid conflicts with the original theme code.

This guide shows how to add a Custom Liquid section and provides an example for adding anchor links to sections.

Add Custom Liquid section

Follow the steps below to add Custom Liquid section and test your custom code.

Admin | Liquid is the template language used by Shopify. See their Liquid reference guide to learn more. Also check out Shopify's Liquid code examples.
icon
STEPS

In your Shopify admin:

  1. Click Duplicate on your current theme.
  2. Click Customize on the duplicated, unpublished theme version.

In your theme editor (Customize):

  1. Open a Template.
  2. Under Template, click (+) Add section and select Custom Liquid.
  3. Click the Custom Liquid section to open the settings.
  4. Enter your HTML or Liquid code into the Custom Liquid field.
  5. Refer to Shopify's Liquid reference guide to learn more.
  6. Click Save.
  7. Click Preview to review your changes.
  8. Use the preview link to further test your changes on multiple browsers and devices.
  9. After testing, you can Publish the theme with your changes.

Add anchor links to sections

If you want to link to a specific section on a page, you can use a Custom Liquid section with some HTML as a workaround.

This method involves adding a Custom Liquid section directly above the section you want to link to. Then you can add an empty span with an id property, and use that id as an anchor link.

Since the Custom Liquid span will be empty, it will not affect the page layout but the link will scroll to the top of the section you want to show.

Admin | Shopify dynamically generates ids for sections but these ids are not stable. Adding custom ids is a workaround for this platform limitation.
icon
STEPS

In your theme editor (Customize):

  1. Under Template, click (+) Add section and select Custom Liquid.
  2. Click and hold the drag and drop handles ⋮⋮ to move the Custom Liquid section directly above the section you want to link to.
  3. Click the Custom Liquid section to open the settings.
  4. Enter the following HTML code and enter a unique id property in the opening tag. If using multiple words, you must use dashes (-) instead of spaces.
  5. <span id="our-values"></span>
    Recommended: Use an ID that's the same name as your section, and make sure the name is not used by other IDs.
    image
  6. Set both the Top spacing and Bottom spacing to 0px.
  7. Find and click the section or block that will link to the Custom Liquid section.
  8. In the link field, enter the id with a hashmark at the start (e.g. #our-values).
  9. To link from another page or menu link, you must enter the full URL path with the anchor link at the end (e.g. www.store.com/#our-values or www.store.com/about#our-values). Use Preview to test the link—it will not work within the theme editor.

    image
  10. Click Save.