Email Templates (Pro)
Pro - Custom email templates require Eventonomy Pro.
Eventonomy Pro lets you customize the subject line and body of fifteen of Eventonomy's emails, and shows a live preview of the real email as you type. Every template ships with a sensible default; you can edit any field or leave it as-is. Placeholders let you inject dynamic event and attendee data into each message.
What You Will Learn
- Which emails you can customize
- Where to edit templates and how the live preview works
- All available placeholders
- What happens to an email you have never edited
Where to Edit Templates
Go to Eventonomy → Settings → Email templates. (Sender name, sender address and reminder timing stay under Messaging; the tab links to them.)
- Pick an email from the Email menu. One template is shown at a time, beside its preview.
- Edit the Subject and Body. Click a placeholder chip under the body to insert it at the cursor.
- Watch the Live preview update as you type. It is the real email renderer with sample data from your latest event, so the layout, buttons and calendar links look like a real send. Switch between Desktop and Phone width to check both. Nothing is saved or sent by the preview.
- Click Save changes at the bottom of the screen.
Two more buttons sit under each template:
- Reset to default puts the shipped subject and body back in the fields (save to keep it).
- Send test to me emails the saved version to your own address (the admin signed in), using your latest event. Save first, or the test shows your previous text.
The preview needs JavaScript. Without it, every template is shown in a stack, still editable, with no preview and no picker.
Your saved wording always wins over a newer default. Once you edit a template, that text is stored and Eventonomy stops applying its own default to that field. If a later release improves a default (for example by adding the
{calendar_links}or{manage_link}row), your saved copy will not pick it up automatically - add the placeholder yourself, or click Reset to default to get the current shipped default.
Templatable Emails
| Template | When it fires |
|---|---|
RSVP confirmation (rsvp_confirmation) |
Attendee submits a Going / Maybe RSVP |
Event submitted, admin (event_submitted) |
A member creates a new event (sent to site admins) |
Event reminder (event_reminder) |
Before the event starts (1 day + 1 hour by default; Pro adds custom timing) |
Order confirmation (order_confirmation) |
A paid order completes successfully |
Donation receipt (donation_receipt) |
A donation on an RSVP is paid |
Complimentary ticket (comp_ticket) |
An organizer gives someone a free ticket |
New event from your follows (new_event) |
An organizer someone follows publishes a new event |
Added to the waitlist (rsvp_waitlisted) |
Someone joins a waitlist |
Waitlist spot opened (rsvp_waitlist_promoted) |
A waitlisted attendee is promoted to Going |
Registration cancelled (rsvp_cancelled) |
A registration is cancelled, by the attendee or the organizer |
Manage-booking link (magic_link) |
A guest asks for their secure link |
Event cancelled (event_cancelled) |
An event is cancelled, sent to registered people |
Event updated (event_updated) |
An event's details change, sent to registered people |
Event approved (event_approved) |
You approve a member's event |
Event not approved (event_rejected) |
You reject a member's event |
The last eight were added in 1.8.0. The defaults of these eight reproduce the wording Eventonomy already sent, and Eventonomy keeps sending its built-in email until you edit that field. So nothing changes for an email you never open.
A master toggle Send the order confirmation email when an order is paid was removed: every paid order sends its receipt. A site that must suppress it can use the evnm_send_order_receipt filter.
Other emails, such as organizer blasts and payout receipts, keep Eventonomy's built-in wording and are not editable here. Adjust those with the hooks below.
Placeholders
Use these placeholders in any subject or body field. They are replaced with live data when the email is sent.
Common Placeholders
| Placeholder | Value |
|---|---|
{site_name} |
Your WordPress site name (from Settings → General). |
{site_url} |
Your site's home URL. |
{event_title} |
The event's title. |
{event_date} |
The event's next occurrence date (formatted per your WordPress date format). |
{event_url} |
The full URL to the single-event page. |
{guest_name} |
The attendee's name (member display name or guest-entered name). Falls back to "there" when no name is known, so the greeting never reads "Hi ,". |
{event_button} |
A View event button linking to the event page. |
{event_details} |
The event date and venue on one line. Available in the waitlist, cancellation, update and approval emails. |
{calendar_links} |
An inline Add to calendar: Google - Outlook - Apple row for the event. Included in the shipped defaults for RSVP confirmation, event reminder and order confirmation. It renders as nothing when the email has no event attached, so it is always safe to leave in. |
{manage_link} |
An inline View or change your RSVP link to a guest's secure manage page. Included in the shipped default for RSVP confirmation. It renders for guests whenever the RSVP confirmation email is sent (not tied to the Manage RSVP by secure link toggle - a guest's only recovery path is never removed by a setting) and renders as nothing for member registrations, so it is always safe to leave in. |
Placeholders for Specific Emails
| Placeholder | Value | |
|---|---|---|
{cancelled_by} |
Registration cancelled | "the organizer" or "you". |
{rejection_reason} |
Event not approved | The reason you typed when rejecting the event, or nothing when you gave none. |
{organizer_name}, {follows_link}, {follows_url} |
New event from your follows | The organizer's name, a Manage what you follow button, and the address of the member's Following page. |
Order Confirmation Placeholders (order_confirmation only)
| Placeholder | Value |
|---|---|
{order_number} |
The order's order number (includes prefix if configured). |
{buyer_name} |
The buyer's name from the order. |
{order_total} |
The order total, currency-formatted. |
{price_breakdown} |
A full HTML table of subtotal, discount, fee, tax, and total. Insert it in the body to give attendees a receipt. |
Note:
{price_breakdown}outputs an HTML<table>. It is safe to insert it in the body. Early-bird pricing is noted automatically if it was applied to the order.
The Manage-Booking Link Email
The guest's secure-link email (magic_link) can be edited like the others, but keep {manage_link} in the body. That placeholder is the dynamically generated one-time link; without it the email has no way back for the guest. Reset to default restores it.
Customizing Templates with Hooks
Templates are applied through the evnm_email_subject and evnm_email_body filters at priority 10. If you also use those filters (priority other than 10), they compose cleanly.
// Override the reminder subject at higher priority (runs after Pro's template).
add_filter( 'evnm_email_subject', function( $subject, $email_key, $data ) {
if ( 'event_reminder' === $email_key ) {
$subject = 'Heads up: ' . $subject; // prepend without replacing Pro's template.
}
return $subject;
}, 20, 3 );
What's Next?
See how one-click unsubscribe and suppression work on notification emails.