Formatting
Type these codes into any text field that supports dynamic text. They’re converted when the block shows at checkout.
Text styles
Section titled “Text styles”| Type this | You get |
|---|---|
**Free returns** |
Bold text |
{@red Final sale} |
Red text, using your checkout’s error color |
{@boldRed Final sale} |
Bold red text |
{@subdued Ships in 3–5 days} |
Gray, lighter text |
{@strikethrough $49.99} |
Text with a line through it, for old prices |
{@small Taxes calculated at the next step} |
Smaller text |
{@extraSmall Terms apply} |
Smaller text (currently the same size as small) |
{@medium …}, {@large …} and {@extraLarge …} are accepted but show at normal size, because Shopify’s checkout doesn’t allow larger body text.
Discount badges
Section titled “Discount badges”| Type this | You get |
|---|---|
{@discountTag 20% OFF} |
A badge with a discount icon and the text “20% OFF” |
{@discountIcon} |
A discount tag icon on its own |
| Type this | You get |
|---|---|
[Returns policy](https://example.com/returns) |
A link that opens in a new tab |
[Size guide]@(https://example.com/size-guide) |
A link that opens in the same tab |
[Call us](tel:+15555550123) |
A phone link |
[Email us](mailto:help@example.com) |
An email link |
You can put several links in one field.
Put checkout values in a link
Section titled “Put checkout values in a link”Inside a link’s address, {Attribute name} is replaced with the value of the cart attribute of that name. This is useful with values collected by a form field:
[Track your gift card balance](https://example.com/balance?card={Gift card number})If the attribute doesn’t exist, the placeholder is removed. This works in body text, not in Line item text or checkbox labels.
Tooltips
Section titled “Tooltips”| Type this | You get |
|---|---|
Read our [terms]<Orders ship within 2 business days. No returns on sale items.> |
“terms” becomes clickable and shows the text in a small popover |
{@!tooltip Not eligible for returns} Final sale |
A small alert icon; clicking it shows “Not eligible for returns” |
Line breaks and spacing
Section titled “Line breaks and spacing”Each new line in a text field starts a new line at checkout. A blank line adds extra space, like a paragraph break.
Rules for combining codes
Section titled “Rules for combining codes”Codes can’t go inside each other. **{@red Final sale}** or a link inside bold text won’t display correctly. Put codes next to each other instead:
{@boldRed Final sale} — **no returns**{{ }} is the exception. Expressions run first, so an expression can output formatting, and formatting can wrap an expression:
{@strikethrough {{ toMoney(compareAtPrice, currencyCode) }}}{{ lineQuantity > 1 ? '**Bulk price applied**' : '' }}Some characters end a code early.
}ends a{@…}code, so the text inside can’t contain}.)ends a link address, and>ends a tooltip.- The
|character is removed from any line that uses formatting.
Fields with limited formatting
Section titled “Fields with limited formatting”- Checkbox labels (the Checkbox block and the SMS consent checkbox) keep links only. Other codes show as plain text: a tooltip
[text]<tip>becomes “text (tip)”. - Banner titles don’t support formatting; codes show exactly as typed. Expressions in
{{ }}still work. - Subheadings support every code. Each line becomes its own heading.
Thank you and order status pages
Section titled “Thank you and order status pages”Blocks on the thank you and order status pages support links (new tab), **bold**, {@red}, {@boldRed}, {@subdued}, and the size codes in body text.
- Tooltips,
{@strikethrough},{@discountTag},{@discountIcon}and same-tab links aren’t available in body text there. Line item text on those pages does support them, except same-tab links and sizes. - An expression’s output shows as plain text in body text:
{{ }}can’t output formatting there. - Headings support links and
{{ }}only.