Skip to main content

How to use merge tags

Insert personalized and dynamic fields into your email campaigns

Written by Mark

All the data related to each contact in the Hive is tied to a unique label called Merge Tags. Merge tags will allow you to add personalized, dynamic content to:

- Subject Lines
- Preview Text
- Email campaigns
- SMS campaigns
- Automations


How to find merge tags in Hive

On the template editor page, you can find the merge tags by clicking the Merge Tag button in the bottom row.


Types of merge tags

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 recipient

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

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

  • Unsubscribe URL
    {{ user.unsubscribe_url }}

    Inserts a URL opt-out link that will take the recipient to a confirmation page once clicked

  • Double Opt-In Url [filter the contact list for anyone who clicked this URL] - can link to the website or a separate page to confirm subscription
    {{ user.double_opt_in_url|redirect_to:'YOURURL.com' }}

    Insert a link to a URL of your choosing to confirm subscription. You can also filter your contact list for anyone who clicked this URL to see who opted in twice

  • Subscription Preferences URL

    {{ user.subscription_preferences_url }}

    Inserts the URL of the recipients' email preferences page

  • Custom User Property

    {{ user.custom_user_property|name:'YOUR PROPERTY NAME' }}

    Inserts the Custom User Property field name that was set when importing from CSV

    Check out this article for How to Use Custom User Properties


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)


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.


Ticketing order merge tags

  • Order Total Amount
    {{ ticketing_order.total_paid }}
    Inserts the total amount paid by the customer for the order.

  • Event Name
    {{ event.name }}
    Inserts the name of the event.

  • Event URL
    {{ event.url }}
    Inserts a link to the event’s dedicated webpage, allowing recipients to view more details or make further actions like purchasing tickets.

  • Venue Name
    {{ event.venue_name }}
    Inserts the name of the venue where the event will be held.

  • Event Start Date/Time
    {{ event.start_date_time }}
    Inserts the start date and time of the event.

  • Event Door Open Date/Time
    {{ event.doors_open_date_time }}
    Inserts the date and time when the doors to the venue will open for the event.

  • Event Description
    {{ event.description }}
    Inserts a brief description of the event. This could be a summary or details about what attendees can expect.

  • Event Primary Act Name
    {{ event.primary_act_name }}
    Inserts the name of the primary act or headliner for the event.

  • Event Supporting Act Name
    {{ event.supporting_act_name }}
    Inserts the name of the supporting act for the event.

  • Event Image URL

    {{ event.image_url }}
    Inserts a link to an event 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 (this can be set up in your contest details).


Ticketing event merge tags

  • Event Primary Act Name
    {{ event.primary_act_name }}
    Inserts the name of the primary act or headliner for the event.

  • Event Description
    {{ event.description }}
    Inserts a brief description of the event. This could be a summary or details about what attendees can expect.

  • Event Door Open Date/Time
    {{ event.doors_open_date_time }}
    Inserts the date and time when the doors to the venue will open for the event.

  • Event Image URL

    {{ event.image_url }}
    Inserts a link to an event image.

  • Event Name
    {{ event.name }}
    Inserts the name of the event.

  • Event Start Date/Time
    {{ event.start_date_time }}
    Inserts the start date and time of the event.

  • Order Total Amount
    {{ ticketing_order.total_paid }}
    Inserts the total amount paid by the customer for the order.

  • Event Supporting Act Name
    {{ event.supporting_act_name }}
    Inserts the name of the supporting act for the event.

  • Event URL
    {{ event.url }}
    Inserts a link to the event’s dedicated webpage, allowing recipients to view more details or take further actions like purchasing tickets.

  • Venue Name
    {{ event.venue_name }}
    Inserts the name of the venue where the event will be held.


Presale merge tags

  • Presales Ticket Link
    {{ presale.url }}
    Inserts the URL to purchase presale tickets for the event.

  • Presales Event URL
    {{ presale.image_url }}
    Inserts a link to an image associated with the presale event.

  • Presales Code
    {{ presale.code }}
    Inserts the presale code that allows recipients to access presale tickets.

  • Presales Ticket Sale Start Date

    {{ presale.start_date }}
    Inserts the date when presale ticket sales begin.

  • Presales Ticket Sale End Date
    {{ presale.end_date }}
    Inserts the date when presale ticket sales end.

  • Presales Registration Start Date
    {{ presale.registration_start_date }}
    Inserts the date when presale registration opens.

  • Presales Registration End Date
    {{ presale.registration_end_date }}
    Inserts the date when presale registration ends

  • Presales Registration Link
    {{ presale.registration_url }}
    Inserts the URL where recipients can register for access to the presale registration page.


Signup form merge tags

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

  • Signup Form Spotlight URL
    {{ signup_widget.url }}
    Inserts the URL of the corresponding signup form in the email automation you've set up. You can use it to link text, a button, or an image.

  • Signup Form Image URL (small)
    {{ signup_widget.image_url_small }}
    Inserts the URL for a 300px by 300px version of the image in your signup form details. ou can use it in the image link space in the drag-and-drop editor or in HTML templates.

  • Signup Form Image URL (large)
    {{ signup_widget.image_url_large }}
    Inserts the URL for a 600px by 600px version of the image in your signup form details. You can use it 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 form settings). You can use it to link text, a button, or an image.


Shopify abandoned order merge tags

  • Order Recovery URL
    {{ order.recovery_url }}
    Inserts a direct link for the recipient to resume the abandoned order.

  • Total Price
    {{ order.total_price }}
    Inserts the total price for the abandoned orders.


Shopify completed order merge tags

  • Order Status URL
    {{ order.status_url }}
    Inserts a direct link for the recipient to view the order details and status.

  • Total Paid
    {{ order.total_paid }}
    Inserts the total amount paid for the order.


Ecommerce order merge tags

  • Order Total Amount
    {{ ecommerce_order.total_paid }}
    Inserts the total amount paid for the order.


How to customize your merge tags

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
    Example: {{ user.first_name|default:"there" }}  Hi, → Hi there,

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

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

  • Uppercase
    {{ example merge tag|upper }}
    Changes the value in the merge tag to be all uppercase
    Example: {{ 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
    Example:
    {{ 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
    Example:
    {{ 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)
    Example:
    point{{ contest.num_entries_remaining|pluralize }} You can still earn 3 points → You can still earn 3 points
    entr{{ contest.num_entries_earned|pluralize:"y:ies" }} You've earned 2 entry → You've earned 2 entries


Related articles

Did this answer your question?