Placeholders
Overview
Placeholders allow you to dynamically personalize content in your mailings, e.g. with the recipient’s name or event-specific information. They are automatically replaced with the matching event/contact data when the mailing is sent.
Where can placeholders be used?
You can use placeholders in multiple parts of a mailing template:
- Subject: To personalize the subject line (e.g. with the event name or recipient’s name).
- Text blocks: In the actual email body to insert salutations, names or individual information.
- Button text: For personalized button labels.
- Button link: For personalized links, e.g. individual registration or confirmation links.
- Image link: For personalized links behind an image.
- QR code link: For personalized QR codes, e.g. personalized registration or check-in links.
- Footer text: To dynamically display organization or event-specific information.
Using placeholders
Placeholders follow a defined format (e.g. {{first_name}}), which is automatically replaced when sending.
Which placeholders are available depends on the data stored on the event and the contact.
General examples:
{{first_name}}– Contact’s first name{{last_name}}– Contact’s last name{{event_title}}– Event title{{organization_title}}– Organization name
The concrete list of available placeholders may vary depending on your organization and event configuration.
Example: placeholders in links / URL parameters
A common use case for placeholders is passing information to an external landing page via URL parameters. This allows voucher codes or the contact’s name/email to be prefilled on the target page.
A sample link could look like this:
https://www.eventseite.de?voucher={{voucher}}&givenname={{first_name_uri}}&familyname={{last_name_uri}}&mail={{email_uri}}#tickets
{{voucher}}: Contact’s personal voucher code.{{first_name_uri}}: Contact’s first name, already URL-encoded (e.g. spaces →%20) so it can be safely used in the link.{{last_name_uri}}: Contact’s last name, URL-encoded.{{email_uri}}: Contact’s email address, URL-encoded.
When sending, these placeholders are automatically replaced with the respective contact’s data. The external page can then read the parameters and prefill fields such as first name, last name, email or voucher.
Best practices
- Only use meaningful placeholders: Insert placeholders only where you can reasonably expect data (e.g. first names only if you store them in your contacts).
- Consider fallbacks: Phrase texts so that they still read well if a placeholder is empty (e.g. neutral salutation instead of always requiring a first name).
- Send test email: Always send test mails to yourself before going live to verify that all placeholders resolve correctly – especially for parameterized links.
Summary
With placeholders you can make your mailings highly individual and personal. Use them wherever you want to dynamically insert data from contacts, events or your organization into your emails.