Rich text

Rich text shows a block of text. You can use formatting such as bold, links, and lists, and variables such as the customer’s name. Rich text is also shown on the Free plan.

Settings

• Display label: Small text shown above the body (optional).
• Body: The text to show (required).
• Copyable: Shows the body in a read-only field so customers can copy it, for example a discount code. When this is on, formatting isn’t applied and the text is shown as written.

Formatting

Write	Shows as
**bold**	bold
*italic*	italic
[link text](URL)	A link
- item	A bulleted list
A blank line	A new paragraph

Variables

Variables in the body are replaced with each customer’s own values. Click a variable to see how to write it and what it shows.

Variable	Shows
{{customer.firstName}}	The customer’s first name
{{customer.lastName}}	The customer’s last name
{{customer.displayName}}	The customer’s display name
{{customer.email}}	The customer’s email address
{{customer.tags}}	The customer’s tags (comma-separated)
{{order.name}}	The order number (for example, #1001). Only available in blocks on the order status page

If a value isn’t set, nothing is shown.

Conditions

Use {% if %} to show part of the text only to some customers. You can use contains, == (equal), != (not equal), or check whether a value exists.

Show text by customer tag

Shows (customers tagged “VIP”): Here’s an exclusive offer for our VIP members.

Shows (everyone else): Join our membership to unlock rewards.

{% if customer.tags contains "VIP" %}
Here's an exclusive offer for our VIP members.
{% else %}
Join our membership to unlock rewards.
{% endif %}

Add more conditions

With {% elsif %}, conditions are checked from the top, and the first match is shown.

Shows (customers tagged “Silver”): Silver members get free shipping on orders over $50.

{% if customer.tags contains "Gold" %}
Gold members always get free shipping.
{% elsif customer.tags contains "Silver" %}
Silver members get free shipping on orders over $50.
{% else %}
Join our membership to unlock free shipping.
{% endif %}

Compare values

== shows the text when the values are equal, and != when they aren’t.

Shows (customers without a first name): Please add your name to your profile.

{% if customer.firstName == "" %}
Please add your name to your profile.
{% endif %}

Show text only when a value exists

Shows (a customer named Emma): Hi Emma!

Shows (customers without a first name): Nothing.

{% if customer.firstName %}
Hi {{customer.firstName}}!
{% endif %}

To show or hide a whole section, use the section’s display conditions.

Variables and conditions also work in the text and URL of links.

Examples by variable

{{customer.firstName}}: First name

Replaced with the customer’s first name. If it isn’t set, nothing is shown. If some customers may not have a first name, combine it with Show text only when a value exists.

Shows: Hi Emma, thanks for shopping with us.

Hi {{customer.firstName}}, thanks for shopping with us.

{{customer.lastName}}: Last name

Replaced with the customer’s last name. If it isn’t set, nothing is shown.

Shows: Welcome back, Ms. Smith.

Welcome back, Ms. {{customer.lastName}}.

{{customer.displayName}}: Display name

Replaced with the name Shopify shows for the customer. This is usually their first and last name, or their email address if no name is set.

Shows: Account details for Emma Smith

Account details for {{customer.displayName}}

{{customer.email}}: Email address

Replaced with the customer’s email address.

Shows: We'll send updates to emma@example.com.

We'll send updates to {{customer.email}}.

{{customer.tags}}: Customer tags

Shows the customer’s tags, separated by ”, ”. If there are no tags, nothing is shown. To change the text by tag, use Show text by customer tag.

Shows: Your tags: VIP, Gold

Your tags: {{customer.tags}}

{{order.name}}: Order number

Replaced with the order number. Only available in blocks on the order status page. Nothing is shown in blocks on other pages or on custom pages.

Shows: Shipping details for order #1001

Shipping details for order {{order.name}}