Variables are a way for you to insert dynamic and customized content in your journey messages so you can address your customers by name, send their exact tracking link, mention some custom properties etc. The list below will expand on the most important variables and their uses.
Important: Please always add a fallback value for each variable you add.
General variables
Usable with all trigger types
Contact:
- Preferred Name -> This is the contact name in WhatsApp, most commonly used
- First Name -> Rarely used, configured via the UI or contact imports
- Last Name -> Rarely used, configured via the UI or contact imports
- Name -> This name is pulled from the shop systems, e.g. Shopify, Klaviyo... if there isn't a shop system integration, do not use this variable
- Nickname -> Rarely used, configured manually from the contact card
- Birthday -> The date set in the Birthday contact property
- Email -> Contact's saved email address
Custom properties:
Here you will find a list of all the custom properties you have configured in the universe, if any, so these options are unique to you.
Message subscriptions:
- First subscribed date -> When the contact opted in
- Last unsubscribed date -> When the contact last opted out
- Last updated subscription name -> The name of the last opt-in or opt-out they interacted with
- Last updated subscription status -> This can be opted-in (granted) or opted-out (withdrawn, denied)
- Last updated subscription timestamp -> When the last changes took place, when they opted in or when they changed their mind and opted out
Trigger message:
body: The message body/text that triggered the flow -> Not that this is only filled if the flow was triggered by a message.
Shop variables
Usable with all Shop System trigger types
Order:
- Custom ID -> Order ID, or order number
- Name -> Order label
- Summary -> This is where the product names and other information about them in the order are being pulled from your Shopify settings. To see and change what would is included in it, you should check your store settings on the Shopify side
- Gross total -> Gross sum of the order, this is the paid amount
- Net total -> Paid amount without the VAT
- Tax -> The value of the taxes on this purchase, or VAT
- Total discount -> If a discount code was applied, how much was the final receipt reduced by
- Currency -> The currency in which the order was paid in
Variables exclusive to Parcel Sent and Tracking URl Changed triggers
Fulfillment:
- Provider -> This is the delivery provider, e.g. DHL
- Tracking URL -> The tracking link for the purchase
- Tracking ID -> This ID can be manually entered by clients in the tracking provider's website to follow the delivery. It's already included in the Tracking URL variable, but it can be listed separately
Variables exclusive to Abandoned cart trigger
Order section is renamed to Abandoned Cart, with one addition:
- Abandoned cart URL -> This leads them directly to the abandoned cart so they can continue shopping
Other external triggers
Klaviyo, Emarsys, or any other similar integration will have its own set of variables which you have to define in the trigger, then you use in your flow from the separate section e.g. Klaviyo Webhook Trigger variable group.
You can also define your own custom variables using the Define Variable node and Liquid code, for which you can use the guide here.