This article explains how to use placeholders in emails, on the landing page, and in the wallet to automatically personalize content with event and guest data.
OVERVIEW
Placeholders allow you to automatically insert dynamic content such as guest names, event details, or links into your communication. All placeholders follow the format {{placeholder_name}}.
You can use placeholders in three places:
| Area | Description |
| Email Templates | Personalized emails with guest data, event info, and links |
| Landing Page | Dynamic content in the text editors of the landing page |
| Wallet / PDF Ticket | Personalized fields and texts on tickets |
PLACEHOLDERS IN EMAILS AND PDF TICKETS
In the email editor, you will find the Find placeholder button, which lets you select from an extensive list of placeholders.
Placeholder Groups
| Group | Description |
| Event Information | Name, start date, location, and other details of your event |
| Guest Information | All contact fields including custom fields |
| URLs | Landing page URL, unsubscribe link, and other useful links |
| Companions | List of all companions or their number |
| Salutations | Predefined salutation blocks with conditions (Twig-based) |
|
Note: The Salutations group uses Twig conditions for gender-specific salutations. Learn more in the article Dynamic Content with TWIG. |
PLACEHOLDERS ON THE LANDING PAGE
You can also use placeholders in the text editors of the landing page. The landing page offers its own selection of available placeholders, which you can insert using the same selection mechanism as in the email editor.
PLACEHOLDERS IN THE WALLET
In the wallet, you can use placeholders in the three front-side fields as well as in the back-side text. The available placeholder list corresponds to that of the email templates.
More information on handling tickets can be found in the article Customizing Wallet/PDF Tickets.
FORMATTING EVENT START AND END TIMES
Placeholders for start and end dates support localized date formatting using the function format_datetime().
Example
| {{event.starts_at|format_datetime(locale=guest.preferred_locale,timezone='Europe/Berlin',pattern='EEEE d.MM.yyyy - HH:mm')}} |
| Parameter | Description |
| event.starts_at | Event start date and time |
| format_datetime() | Function for formatting date and time |
| locale | Language and format based on the guest’s preferred language |
| timezone | Event time zone, e.g., 'Europe/Berlin' |
| pattern | Format pattern: EEEE = weekday, d.MM.yyyy = date, HH:mm = time (24h) |
PLACEHOLDER REFERENCE
LINKS
| Description | Placeholder |
| Landing page URL | {{event.centerstage_public_url}} |
| Landing page URL with code | {{guest.landing_page_url_with_login_code}} |
| Unsubscribe link (email only) | {{guest.email_unsubscribe_url}} |
| Wallet download URL (email only) | {{guest.wallet_pass_download_url}} |
GUEST DETAILS
| Description | Placeholder |
| Guest code | {{guest.code}} |
| Guest status | {{guest.status}} |
| Gender | {{contact.sex}} |
| Title | {{contact.title}} |
| First name | {{contact.first_name}} |
| Last name | {{contact.last_name}} |
| Full name | {{contact.full_name}} |
| Job title | {{contact.job_title}} |
| {{contact.email}} | |
| Company | {{contact.company_name}} |
| Address 1 | {{contact.address_line_1}} |
| Address 2 | {{contact.address_line_2}} |
| ZIP code | {{contact.zip}} |
| City | {{contact.city}} |
| Country | {{contact.country}} |
COMPANIONS
| Description | Placeholder |
| List of companions | {% for companion in guest.companions %} {{companion.contact.full_name}} {% endfor %} |
| Number of companions | {{guest.companions|length}} |
RECOMMENDATIONS
| Description | Placeholder |
| List of recommended guests | {% for recommended_guest in guest.recommended_guests %} {{recommended_guest.contact.full_name}} {% endfor %} |
| Number of recommendations | {{guest.recommended_guests|length}} |
FREQUENTLY ASKED QUESTIONS
Where can I find custom fields as placeholders?
Custom fields can be found in the Guest Information group in the placeholder menu. They are automatically listed once they have been created in your event.
Can I use placeholders in the subject line of an email?
Yes, placeholders such as {{contact.first_name}} or {{event.name}} can also be used in the subject line.
What happens if a placeholder has no value?
If no value is stored for a guest, the placeholder remains empty. No error is shown, but the content is missing in that place.
Do all placeholders work in all places?
Not all placeholders are available everywhere. The landing page has its own selection, while the unsubscribe link and wallet download URL only work in emails.