Liquid Templates

  • Updated

organizers_only.jpgAll_plans_.png

Liquid Templates are custom fields that make your Hopin emails personalized for recipients.

By adding available liquid tags to your custom email you will be able to personalize your email(s) with:

  • Event information
  • Registered attendee information
  • Organizer information
  • Sponsor information
  • Schedule information
  • Speaker information
  • Magic links
  • QR codes for onsite and hybrid event access

Note: The available liquid tags list will differ slightly with Free and Starter plans, as it will only be possible to create individual emails from your Event Dashboard > Marketing > Email attendees. Meanwhile Growth and Advanced plans will have an additional Customize emails page accessible through Event Dashboard > Marketing > Customize Emails, check this article for additional information.

Tags

Event

{{event.name}}{{event.link}}{{event.currency}} 
{{event.calendar_link}}{{event.original_picture}}{{event.medium_picture}}

User

{{user.name}}{{user.first_name}}{{user.last_name}}

Organiser

{{organiser.name}}{{organiser.website}}{{organiser.picture}}

Order

Note: These tags are available only when customizing the “Order Confirmation” template

{{order.summary}}{{order.join_event_button}}

Sponsor

Note: These variables are slightly different, please see examples below

{{sponsor.website}}{{sponsor.name}}{{sponsor.logo}}

Schedule

Note: These variables are slightly different, please see examples below

{{schedule.name}}{{schedule.start_time}}{{schedule.end_time}}{{schedule.description}}

Speaker

Note: These variables are slightly different, please see examples below

{{speaker.name}}{{speaker.headline}}

Other

{{extra.redeem_link}}{{extra.delete_link}}{{registration.price}}

QR Codes

Note: follow the steps for image tags to include this tag correctly.

{{ registration.qr_code_image_url }}

Types of Tags

Select a type of tag from the drop down options below to learn how to properly insert them into your emails

  • Text tags

    Text tags should be simply written down within the editor.

    Untitled.png

  • Image tags

    Image tags are bit more tricky, but our editor helps along the way.

    Below are the current image tag variables available.

    {{event.original_picture}}
    {{event.medium_picture}}
    {{organiser.picture}}
    {{sponsor.logo}}
    {{ registration.qr_code_image_url }}

    Note: Bear in mind the sponsor variables are different, please check the sponsor section.

    Here's a video showing how it's done.

    1. Copy tag you want to use, this will help prevent mistakes
    2. Click on the image icon, make sure the cursor is on the place you want to add the image
    3. Fill the URL field with the tag
    4. Optionally, fill the field below with a tag or text explaining what the image is
  • Link tags

    Link tags also need some magic to work properly, but the editor helps along the way.

    Below are the current link tag variables available.

    {{event.link}} {{event.calendar_link}}{{organiser.website}}{{extra.redeem_link}} 
    {{extra.delete_link}} {{sponsor.website}}

    Note: Bear in mind the sponsor variables are different, please check the sponsor section.

    1. Copy the tag you want to use, to help prevent mistakes
    2. Click on the anchor icon, make sure the cursor is on the place you want to add the link
    3. Fill the anchor text, this is the text shown as the link
    4. Use a variable in URL field
  • Sponsors tags

    These tags need to be inside a loop. There can be multiple sponsors for a given event, you need to be able to list them all.

    Example: Let's say a certain event has 3 sponsors: Sponsor A, Sponsor B and Sponsor C. Below is an example of how you can list all of them and show their names.

    {{event.sponsors}} 
    Has the data on all 3 sponsors, in order to handle each one,
    you need to use a loop

    {% for sponsor in event.sponsors %}
    This is a loop, it will list sponsors one by one

    <p>{{sponsor.name}}</p>
    This is print the sponsor name 3 times

    {% endfor %}
    This is where the loop stops

    Schedule tags

    The schedule can be split into multiple days for a given event, so in order to list all its parts, you need to use these tags inside a loop.

    Example: Let's say a certain event has a 2 day schedule - with 5 sessions happening today and 3 happening tomorrow. Below is an example of how you can list all of them and show their start times. Please note that all schedules will be sorted by start time of the schedule.

    {{event.all_schedules}}
    Has the data on all 8 sessions in the 2 day schedule, in order to handle each one,
    you need to use a loop


    {% for schedule in event.all_schedules %}
    This is a loop, it will list schedules one by one

    <p>{{schedule.start_time}}</p>
    This will print the 8 sessions start times

    {% endfor %}
    This is where the loop stops

    You can also change the base tag in order to list only sessions happening today or tomorrow

    {{event.todays_schedule}}
    Has the data on all 5 sessions in todays schedule, in order to handle each one,
    you need to use a loop


    {{event.tomorrows_schedule}}
    Has the data on all 3 sessions in tomorrow's schedule, in order to handle each one,
    you need to use a loop
  • Speakers tags

    These tags need to be inside a loop. There can be multiple speakers for a given event, you need to be able to list them all.

    Example: Let's say a certain event has a 2 day schedule - with 5 speakers submitted for today and 3 for tomorrow. Below is an example of how you can list all of them and show their names.

    {{event.all_speakers}}
    Has the data on all 8 speakers in the 2 day schedule, in order to handle each one,
    you need to use a loop


    {% for speaker in event.all_speakers %}
    This is a loop, it will list speakers one by one

    <p>{{speaker.name}}</p>
    This will print the 8 speakers names

    {% endfor %}
    This is where the loop stops

    You can also change the base tag in order to list only speakers for today or tomorrow

    {{event.todays_speaker}}
    Has the data on all 5 speakers in todays schedule, in order to handle each one,
    you need to use a loop


    {{event.tomorrows_speaker}}
    Has the data on all 3 speakers in tomorrow's schedule, in order to handle each one,
    you need to use a loop

Removing Tags

If you wish so you can also remove tags from an email template. We will use the announcement email template as an example to remove the {{user.first_name}} tag.

1. To proceed, simply highlight the tag you want to remove, {{user.first_name}} in our case, then delete it using the backspace or delete key on your keyboard.

2. Then click the Update & Preview button at the bottom left to continue.

Screenshot_2021-06-10_at_11.56.15.png

Note: Ensure that after deleting the tag the template text looks fine, with no extra spaces as shown below, otherwise edit further until it does before clicking Update & Preview.

Screenshot_2021-06-10_at_11.56.43.png

3. On the next page check that the text looks as expected and there's no user first name displayed.

4. Then send yourself a test email using the Send Test Email button to make sure all is fine.

Sending your email

Once you have confirmed that the test email looks good, hit Save Template to save the changes, otherwise hit Back to editing if you need to make further edits.

Screenshot_2021-06-10_at_11.57.30.png 



Was this article helpful?