Liquid Templates in RingCentral Events Emails

At RingCentral Events, we support a template language to enable you to insert variables into your email templates.  By adding available liquid tags to your emails 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

We recommend previewing your emails and sending a test email before saving the template and sending it out to your registrants.

Tags

Personalization tags contain the content that will be displayed on a page. Objects and variables are displayed when enclosed in double curly braces: {{ and }}. Here is an example:

Input

{{event.name}}

Output

Women in Tech Annual Conference

In this case, the template language is rendering the content of the name property of the event object, which contains the text Women in Tech Annual Conference.

Event

{{event.name}}
{{event.link}}
{{event.currency}}
{{event.location}} 
{{event.calendar_link}} - the AddEvent calendar invite link (the invite will contain
the magic link) 
{{event.original_picture}}
{{event.medium_picture}}
{{event.replay_link}} - the link to the event Replay area
{{event.post_event_time_end}} - the time the post event experience is ending

User

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

Organiser

{{organiser.name}}
{{organiser.website}}
{{organiser.medium_picture}}

Order

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

{{order.summary}} - the order summary table
{{order.join_event_button}} - an order-based link to join the event

Sponsor

These variables are slightly different, please see refer to the section below.

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

Schedule

These variables are slightly different, please see refer to the section below.

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

Speaker

These variables are slightly different, please see refer to the section below.

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

Other

{{ticket.label}}
{{ticket.price}}
{{registration.price}}
{{extra.redeem_link}} - a link for the magic link (automatically signs in the user and
brings him to the reception page of the event) 
{{extra.delete_link}} - a link to destroy personal data 

QR Codes

{{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.

  

• 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.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.

  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 need to be added as hyperlinks 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. Alternatively, you can highlight the existing text and click on the anchor icon. 
  3. Fill or adjust the anchor text, this is the text shown as the link.
  4. Use a variable in URL field.
     

•  Conditional tags

  Tags create the logic and control flow for templates, so it's possible to create conditional items. The curly brace percentage delimiters {% and %} and the text that they surround do not produce any visible output when the template is rendered. This lets you assign variables and create conditions or loops without showing any of the template language logic on the page.

  Here is an example of how you can add information on refund policies that will be shown to paid ticket holders only:

  {% if registration.paid %} 
  Specific content if the ticket was paid - to mention refund in case of 
  cancellation.
  {% endif %}

• Sponsors tags

  The sponsor tags mentioned above need to be inside of an iteration tag that repeatedly executes a block of code. This way you can list all sponsors added to the event.

  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.

  You can iterate on sponsors using:

  {% for sponsor in event.sponsors %} 
  This is a loop, it will list sponsors one by one
  
    {{sponsor.name}} This is just text
    {{sponsor.website}} This is the website, should be inside a link
    {{schedule.logo}} This is the logos' path, should be inside an image tag
  
  {% endfor %} 
  This is where the loop ends

• Schedule tags

  The sponsor tags mentioned above need to be inside of an iteration tag that repeatedly executes a block of code. This way you can list all scheduled items created in the event.

  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. 

  You can iterate on all event schedule items using:

  {% for schedule in event.all_schedules %}
  This is a loop, it will list schedules one by one
  
    {{schedule.name}} This is just text
    {{schedule.start_time}} This is the start time of the schedule
    {{schedule.end_time}} This is the end time of the schedule
    {{schedule.description}} This is the description of the schedule
  
  {% endfor %}
  This is where the loop ends

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

  {{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
  
  {{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

  The speaker tags mentioned above need to be inside of an iteration tag that repeatedly executes a block of code. This way you can list all speaker profiles added to the event schedule.

  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.

  You can iterate on all event speakers using:

  {% for speaker in event.all_speakers %}
  This is a loop, it will list speakers one by one
  
    {{speaker.name}} This is name of the speaker
    {{speaker.headline}} This is the headline of the speaker
  
  {% 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.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
  
  {{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 the existing liquid tags from an automated 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.

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.

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.