Custom Liquid | SHOP Builder

4. EC + SC (EN).png

You can add the "Custom liquid" widget when editing an advanced page to insert customized texts. You can insert the HTML scripts by yourself or refer to the liquid codes provided by SHOPLINE. 

This article will cover:

⚠️ Before you begin:

  • SHOP Builder currently only supports Ultra Chic, Kingsman, Varm, and Philia themes.
  • After creating a page using SHOP Builder, the page can still be displayed even if you switch to other themes, but it cannot be edited and the layout may be messed up. Please take note of this before publishing the page.


1. Add Custom Liquid Widget

Step 1

Proceed to SHOPLINE Admin > [Online Store Design] > [Pages] and click Advanced Page/Edit to open up the Advanced Page settings page.11.png

Step 2

Click the Widget button.Screen_Shot_2022-08-01_at_4.47.14_PM.png


Step 3

Click the Custom liquid widget under "Extension."

Step 4

Insert customized text in the "Liquid" section. You may insert standard text, HTML scripts, or liquid codes.Screen_Shot_2022-08-08_at_6.15.52_PM.png


If you have experience working with liquid, you may insert the following four types of liquid codes:

A. Shop

Liquid Code



Shop's currency (Abbreviated as example: USD).


Primary domain of the shop.


Shop email


Shop name


Shop's domain. This will be your domain. This code will not be applicable if you have a custom domain.


Shop URL


The encrypted website URL according to HTTPS protocol.


Shop's current locale setting. Below are the value and input samples for each language.

Value for each language:

English / en
中文 / zh-hant
简中/ zh-cn
ไทย / th
Tiếng Việt / vn
日本 / jp
Melayu / my
bahasa Indonesia / id
Deutsch / de
Français / fr


Input sample (for English and Traditional Chinese):

{% if shop.current_locale.code == "en" %}
Content 1
{% elsif shop.current_locale.code == "zh-hant" %}
Content 2
{% else %}
Content 3(languages other than English and Chinese)
{% endif %}


Shop accepted credit cards. For example visa, master, amex, PayPal, prizm, tw_711_pay, tw_fm_pay, allpay, linepay, ecpay, esun, taishin, or sinopac.


Shop's price and currency. For example HK$.


The format of locale settings currently supported by the shop (excluding the current locale setting) is the same as {{shop.current_locale}}.


Shop logo URL


Shop messages feature, if enabled, will execute liquid code.


Shop's multi-currency feature, if enabled, will execute liquid code.


Currencies supported by the shop, including currency name, symbol, and abbreviation.


Shop features


Shop footer's HTML.


B. Page

Liquid Code



Page URL


Identify the page where customers are located.


Checkout page. Liquid code will be enabled when customers are on the checkout page.


Query parameters


C. Theme

Liquid Code



Shop theme


Shop theme settings


Step 5

When setting up, you can click the Save button on the bottom, and a preview screen of the added custom liquid widget will display on the right. You can also preview it in the mobile version. Screen_Shot_2022-08-08_at_6.04.02_PM.png



Or click the Preview button at the top right to view the complete storefront.Screen_Shot_2022-08-08_at_6.06.40_PM.png


Step 6

Once the above is completed, click the Publish button, and customers will be able to see the added content on this page at the storefront.Screen_Shot_2022-08-08_at_6.07.20_PM.png

2. Notes

  • The system will filter or block certain liquids to prevent affecting parts of the HTML that may cause security or online store architecture issues.
  • It is recommended to have a professional customize the liquid in order to avoid any unexpected problems.
  • SHOPLINE does not provide liquid-related guidelines and advice.

Note before editing:

Since SHOPLINE is an online platform that requires regular updates for the system and design, we will not be responsible for any problems that occur with your custom liquid due to the website update. SHOPLINE recommends that you check the page frequently to ensure that your online store is functioning properly.


Read more




Have more questions? Submit a request