Liquid Usage Use Cases & Overview

If you include the following text in your message: {{${first_name}}}, the appropriate value from the user will be interpolated when the message is sent. If you would like to use the value of a custom attribute, you must add the namespace “custom_attribute” to the variable. For example, to use a custom attribute named “zip code”, you would include {{custom_attribute.${zip code}}} in your message.

The following values can be substituted into a message, depending on their availability:

You can also pull content directly from a web server via Braze’s Connected Content feature.

Using Liquid

Once you know the Liquid tags available, using Liquid can elevate the personalization in your messages to impressive heights. Liquid tags act as placeholders in your messages that can pull in consented information from your user’s account and enable personalization and relevant messaging practices. In the block below, you can see that a dual usage of a Liquid tag to call the user’s first name, as well as a default tag in the event that a user would not have their first name registered.

Hi {{ ${first_name} | default: 'Valued User' }}, thanks for using the App!

To a user named Janet Doe, the message would appear to the user as either:

Hi Janet, thanks for using the App!


Hi Valued User, thanks for using the App!

Inserting Tags

You can insert tags by typing {{ in any message, which will trigger an auto-completion feature that will continue to update as you type. You can even select a variable from the options that appear as you type.

If you’re using a custom tag, you can copy and paste the tag into whatever message you desire.

Pre-Formatted Variables

You can insert pre-formatted variables with defaults through the “Insert Personalization Attribute” modal located on the top-right of any templated text field.

Modal buttons

The modal will insert Liquid with your specified default value at the point that your cursor was. The insertion point is also specified via the preview box, which has the before and after text. If a block of text is highlighted, the highlighted text will be replaced.


New Stuff!