All of your contact information in Hive is tied to a unique label called a merge tag. You can use merge tags in the subject line, preview text, and body of your emails to include personalized or dynamic content from your list in the campaigns you send.

Find merge tags by clicking the Merge Tag button in the bottom row of the template editor.

This FAQ covers all the merge tags available in Hive and how you can use them along with filters to customize your campaigns.

User/Recipient Merge Tags

Full Name
{{ user.full_name }}
Inserts the first name and last name of your recipient, separated by a space

First Name
{{ user.first_name }}
Inserts the first name of the recipeint

Last Name
{{ user.last_name }}
Inserts the last name of the recipient

Email Address
{{ user.email }}
Inserts the email address of the recipient

Brand Account Merge Tags

Organization Name
{{ account.organization_name }}
Inserts your Hive organization name (can be found in Settings > Edit Organization Details)

Brand Name
{{ account.brand_name }}
Inserts your Hive brand name (can be found at the top of the left sidebar)

Mailing Address
{{ account.mailing_address }}
Inserts the mailing address associated with your account (can be found in Settings > Edit Email Settings)

Signup Page Campaign Merge Tags

Signup Page Title
{{ signup_widget.title }}
Inserts the title of the corresponding signup page in the email automation you've set up

Signup Page Spotlight URL
{{ signup_widget.url }}
Inserts the URL of the corresponding signup page in the email automation you've set up. Can be used to link text, a button, or an image.

Signup Page Image URL (small)
{{ signup_widget.image_url_small }}
Inserts the URL for a 300px by 300px version of the image in your signup page details. Can be used in the image link space in the drag-and-drop editor or in HTML templates.

Signup Page Image URL (large)
{{ signup_widget.image_url_large }}
Inserts the URL for a 600px by 600px version of the image in your signup page details. Can be used in the image link space in the drag-and-drop editor or in HTML templates.

Signup Page Double Opt-in URL
{{ signup_widget.double_opt_in_url }}
Inserts the specific URL the recipient can click to opt-in to your mailing list (if opt-in is enabled in your signup page settings). Can be used to link text, a button, or an image.

Contest Campaign Merge Tags

Contest Title
{{ contest.title }}
Inserts the title of the corresponding contest in the email automation you've set up

Contest Spotlight URL
{{ contest.url }}
Inserts the URL of the corresponding contest in the email automation you've set up. Can be used to link text, a button, or an image.

Contest Image URL (small)
{{ contest.image_url_small }}
Inserts the URL for a 300px by 300px version of the image in your contest details. Can be used in the image link space in the drag-and-drop editor or in HTML templates.

Contest Image URL (large)
{{ contest.image_url_large }}
Inserts the URL for a 600px by 600px version of the image in your contest details. Can be used in the image link space in the drag-and-drop editor or in HTML templates.

Number of Entries Earned
{{ contest.num_entries_earned }}
Inserts the specific number of contest entries the recipient has completed already

Number of Entries Remaining
{{ contest.num_entries_remaining }}
Inserts the specific number of contest entries the recipient has left to complete

Contest Referral URL
{{ contest.referral_url }}
Inserts the specific URL the recipient can use to get referral entries

Referral Points to Earn
{{ contest.referral_points_to_earn }}
Inserts the number of entries a referral is worth (can be set up in your contest details)

Download Campaign Merge Tags

Download Title
{{ download.title }}
Inserts the title of the corresponding contest in the email automation you've set up

Download Spotlight URL
{{ download.url }}
Inserts the URL of the corresponding download in the email automation you've set up. Can be used to link text, a button, or an image.

Download Image URL (small)
{{ download.image_url_small }}
Inserts the URL for a 300px by 300px version of the image in your download details. Can be used in the image link space in the drag-and-drop editor or in HTML templates.

Download Image URL (large)
{{ download.image_url_large }}
Inserts the URL for a 600px by 600px version of the image in your download details. Can be used in the image link space in the drag-and-drop editor or in HTML templates.

Download File URL
{{ download.file_url }}
Inserts the URL of the file of the corresponding download in the email automation you've set up. Can be used to link text, a button, or an image.

Email/Campaign Merge Tags

Public "View Email in Browser" URL
{{ email.public_url }}
Inserts the public URL of the email campaign. Can be used to link text, a button, or an image.

Share Email on Twitter URL
{{ email.share_on_twitter_url|text:'TWEET TEXT' }}

Inserts the URL to tweet the public URL to the email campaign. Customize TWEET TEXT to change what appears in the tweet automatically. Can be used to link text, a button, or an image.

Share Email on Facebook URL
{{ email.share_on_facebook_url }}

Inserts the URL to share the public URL to the email campaign on Facebook. Can be used to link text, a button, or an image.

Shopify Discount Merge Tags

Unique Discount Code
{{ discount.unique_code|prefix_code:'SHOPIFY-DISCOUNT-CODE' }}
Inserts a unique coupon code associated with a Shopify coupon code. Customize SHOPIFY-DISCOUNT-CODE with one of your pre-existing coupon codes.

Unique Discount Code URL
{{ discount.unique_code|prefix_code:'SHOPIFY-DISCOUNT-CODE' }}
Inserts the URL to a unique coupon code associated with a Shopify coupon code. Customize SHOPIFY-DISCOUNT-CODE with one of your pre-existing coupon codes. Can be used to link text, a button, or an image.

Smile Profile Merge Tags

Points Balance
{{ user.smile_profile.points_balance }}  
Inserts each user's point balance.

State
{{ user.smile_profile.state }}
Inserts the up-to-date state of a user.

Smile Referral URL
{{ user.smile_profile.referral_url }}
Inserts the referral URL that the user can share to earn more points. Can be used to link text, a button, or an image.

VIP Tier
{{ user.smile_profile.vip_tier_name }}
Inserts the name of the VIP tier the user is in.

Filters

Merge tag filters let you customize how the merge tag value appears for the recipient. 

Default
{{ example merge tag|default:"enter text" }}
Enters the default when the recipient doesn't have the relevant information for the merge tag value
Note: If no default is set and the recipient doesn't have the value, nothing will be entered
E.g. {{ user.first_name|default:"there" }}  Hi, → Hi there,

Titlecase
{{ example merge tag|title }}
Changes the value in the merge tag to be titlecase
E.g. {{ user.full_name|title }}  john smith → John Smith

Lowercase
{{ example merge tag|lower }}
Changes the value in the merge tag to be all lowercase
E.g. {{ user.full_name|lower }}  John Smith → john smith

Uppercase
{{ example merge tag|upper }}
Changes the value in the merge tag to be all uppercase
E.g. {{ user.full_name|upper }}  John Smith → JOHN SMITH

Truncate Characters
{{ example merge tag|truncatechars:n }}
Changes the value in the merge tag to be truncated based on character count and adds an ellipsis (...) depending on the number you set (n), where the 3 dots of the ellipsis are included in the character count
E.g.
{{ user.full_name|truncatechars:7 }} John Smith → John...
{{ contest.title|truncatechars:3 }}  New Contest Example → ...
{{ contest.title|truncatechars:14 }}  New Contest Example → New Contest...

Truncate Words
{{ example merge tag|truncatewords:n }}
Changes the value in the merge tag to be truncated based on word count and adds an ellipsis (...) depending on the number you set (n), where the 3 dots of the ellipsis are not included in the character count
E.g.
{{ contest.title|truncatewords:2 }} New Contest Example → New Contest...
{{ signup_widget.title|truncatewords:3 }}  Join Mailing List for Updates → Join Mailing List...

Pluralize
{{ example merge tag|pluralize }}  
Inserts the correct pluralization for the end of the word you use the merge tag with (corresponds with merge tags tied to values, like contest entries earned and remaining)
E.g.
point{{ contest.num_entries_remaining|pluralize }} You can still earn 3 point → You can still earn 3 points
entr{{ contest.num_entries_earned|pluralize:"y:ies" }} You've earned 2 entry → You've earned 2 entries

Did this answer your question?