Available starting May 5, 2026
When building an app page or an email template, you can add merge tags. These are placeholders that will pull the relevant text information from the workspace metadata, and display it to the attendee in the app page or the email.
There are four types of merge tags that can be used to personalize your pages and emails:
- Participant details merge tags (available in pages and in emails).
- New: Event details merge tags (available in pages and in emails).
- Session details (available in emails only).
- Meeting details (available in emails only).
Adding this personalized content is done using the Merge tag button. Merge tags can be used in the:
-
Page display templates, via template’s Text block:
Example: I want to add any type of participant (“activated person”) or workspace metadata to my text box, so that my app page is customized with the attendee or event information.
-
Page display templates, via the Embed block, where users will have to enter the merge tag(s) manually:
Example: I want to configure a single embed block with a third-party based survey URL that dynamically pulls the person and event context via the merge tags.
To note, in embed components only, in addition to the event and person merge tags listed below, Backstage users can utilize the {{activatedPerson._id}} merge tag in order to identify users based on their ID.
-
Email template:
Example: I want to customize my email templates so that they display attendee or event details.
When adding merge tags to pages or email templates, users can add Participant/Activated person details or Event details merge tags:
Participant/Activated person details merge tags
These merge tags are available on page display templates and in the email editor:
This list is very variable as it corresponds to the full list of User metadata that is added to the workspace, including any custom metadata that was created. Some examples include:
| Merge tag name | Metadata |
| User first name | {{fname}} |
| User last name | {{lname}} |
| User organization | {{company}} |
| User email address | {{email}} |
| User position | {{position}} |
| User country | {{country}} |
Event (workspace) details merge tags
These merge tags are available on page display templates and in the email editor:
The event details merge tags are based on the event metadata or variables. This is the information that is added for the workspace, also described in the workspace settings article.
The full list of event details merge tags that are available to be used is as follows:
| Merge tag name | Metadata |
| Workspace name | {{workspace.name}} |
| Workspace ID | {{workspace.id}} |
| Organization name | {{activatedPerson.company}} - available in pages only |
| Event start date | {{workspace.start_date}} |
| Event end date | {{workspace.end_date}} |
| Event location | {{workspace.location}} |
| Event timezone | {{workspace.timezone}} |
| Country name Country name 2 Country name 3 etc |
{{workspace.country}} {{workspace.country.[0]}} {{workspace.country.[1]}} Note: To add more than one item here, you need to manually enter it following the syntax above. It cannot be done via the merge tag button. |
| Country code Country code 2 Country code 3 etc |
{{workspace.country_code}} {{workspace.country_code.[0]}} {{workspace.country_code.[1]}} Note: To add more than one item here, you need to manually enter it following the syntax above. It cannot be done via the merge tag button. |
| Workspace category Workspace category 2 Workspace category 3 etc |
{{workspace.categories}} Note: To add more than one item here, you need to manually enter it following the syntax above. It cannot be done via the merge tag button. |
| Event title customised for in-app display | {{workspace.in_app_display}} |
| Event title used when sending calendar invites | {{workspace.calendar_invite}} |
Note: When adding merge tags via the email editor, users can also add merge tags for session details and meeting details. Session details and meeting details merge tags are not available to be added in app pages.
Session details merge tags
These merge tags are only available in the email editor, not on pages:
- waitlisted_session: {{waitlisted_session}
Meeting details merge tags
These merge tags are only available in the email editor, not on pages, and they are only available when the Meetings or Appointments module is installed.
- meeting_title: {{meeting_title}}
- meeting_date: {{meeting_date}}
- meeting_time: {{meeting_time}}
- meeting_location: {{meeting_location}}
- meeting_participant_count: {{meeting_participant_count}}
- meeting_status: {{meeting_status}}
- meeting_organizer: {{meeting_organizer_fname}} + {{meeting_organizer_lname}}
- meeting_organizer_fname: {{meeting_organizer_fname}}
- meeting_organizer_lname: {{meeting_organizer_lname}}
- meeting_organizer_email: {{meeting_organizer_email}}
- meeting_description: {{meeting_description}}
Comments
0 comments
Please sign in to leave a comment.