Event Details

#_EVENTID

Shows the event ID number in the wp_em_events table.

#_EVENTPOSTID

Shows the event corresponding Post ID in the wp_posts table.

#_EVENTNAME

Displays the name of the event.

#_EVENTNOTES

Shows the description of the event.

#_EVENTEXCERPT

If an excerpt has been added to the event, it will be used. If you added a more tag to your event description, only the content before this tag will show.

#_EVENTEXCERPT{words,...}

If an excerpt has not been added to the event you can use this format #_EVENTEXCERPT{10,...}, where 10 is the number of words to show and ... is what is used at the cut-off point.

#_EVENTEXCERPTCUT

Same as #_EVENTEXCERPT (and also accepts the {words,...} arguments) but will also cut excerpts as well as post content. Default word limit is 55 and cut-off is [...]

#_EVENTIMAGE

Shows the event image, if available.

#_EVENTIMAGE{x,y}

Shows the event image thumbnail, x and y are width and height respectively, both being numbers e.g. #_EVENTIMAGE{100,100}. If 0 is used for either width or height, the corresponding dimension will be proportionally sized

#_EVENTCATEGORIES

Shows a list of category links this event belongs to.

#_EVENTCATEGORIESIMAGES

Shows a list of category images this event belongs to. Categories without an image will be ignored.

#_EVENTTAGS

Shows a list of tag links this event belongs to.

#_EVENTLOCATION

Displays information about the event location, which is different from a physical location. See our documentation for more information, as each location type may display different information and will have different additional placeholders.

#_RECURRINGDATERANGE

Range of dates between the start/end of the recurring event pattern for an event recurrence, blank for non-recurrences.

#_RECURRINGPATTERN

Describes the pattern of a recurring event when used on an event recurrence, blank for non-recurrences.

#_RECURRINGID

The event ID of the recurring event template when displayed on a recurrence, blank for non-recurrences.

Date and Times

These are shortcut placeholders for pre-formatted dates and times. See the Custom Date/Time Formatting section below for more refined formatting placeholders.

#_24HSTARTTIME

Displays the start time in a 24 hours format (e.g. 16:30).

#_24HENDTIME

Displays the end time in a 24 hours format (e.g. 18:30).

#_12HSTARTTIME

Displays the start time in a 12 hours format (e.g. 4:30 PM).

#_12HENDTIME

Displays the end time in a 12 hours format (e.g. 6:30 PM).

#_EVENTTIMES

Displays either a single time, time-span, or "All Day" depending on your event times. Format is taken from your Events Manager settings page.

#_EVENTDATES

Displays either a single date or a date range depending on your event dates. Format is taken from your Events Manager settings page.

Custom Date/Time Formatting

Events Manager allows extremely flexible date formatting by using PHP date syntax format characters along with placeholders.

# or #@

Prepend # or #@ before a valid PHP date syntax format character to show start and end date/time information respectively (e.g. #F will show the starting month name like "January", #@h shows the end hour).

#_{x} or #@_{x}

You can also create a date format without prepending # to each character by wrapping a valid php date() format in #_{} or #@_{} (e.g. #_{d/m/Y}). If there is no end date (or is same as start date), the value is not shown. This is useful if you want to show event end dates only on events that are longer than one day, e.g. #j #M #Y #@_{ \u\n\t\i\l j M Y}.

WordPress-relative Timezone Date/Time Placeholders

These placeholders are extensions of the default Date/Time placholders, but instead will display the time of the event relative to your WordPress timezone rather than the local time of the event itself. Your WordPress site timezone is found in your Dashboard > Settings > General settings page.

#_24HSTARTTIME_SITE

Sames as #_24HSTARTTIME but displays time relative to your site timezone.

#_24HENDTIME_SITE

Sames as #_24HENDTIME but displays time relative to your site timezone.

#_12HSTARTTIME_SITE

Sames as #_12HSTARTTIME but displays time relative to your site timezone.

#_12HENDTIME_SITE

Sames as #_12HENDTIME but displays time relative to your site timezone.

#_EVENTTIMES_SITE

Sames as #_EVENTTIMES but displays times relative to your site timezone.

#_EVENTDATES_SITE

Sames as #_EVENTDATES but displays dates relative to your site timezone (dates can be different for events near midnight in a different timezone).

#__{x} or #@__{x}

Same as #_{x} or #@_{x} but displays the time of the event relative to your WordPress timezone rather than the local time of the event itself.

Viewer Timezone Date/Time Placeholders

These placeholders are extensions of the default Date/Time placholders, but instead will display the time of the event relative to the visitor timezone rather than the local event start time. This time is based on the user browser settings and JavaScript, so this may not always be accurate if a visitor is travelling and does not update their browser timezone, or if they have disabled JS on their browser.

#_24HSTARTTIME_LOCAL

Sames as #_24HSTARTTIME but displays time relative to your visitor browser timezone.

#_24HENDTIME_LOCAL

Sames as #_24HENDTIME but displays time relative to your visitor browser timezone.

#_12HSTARTTIME_LOCAL

Sames as #_12HSTARTTIME but displays time relative to your visitor browser timezone.

#_12HENDTIME_LOCAL

Sames as #_12HENDTIME but displays time relative to your visitor browser timezone.

#_EVENTTIMES_LOCAL

Sames as #_EVENTTIMES but displays time relative to your visitor browser timezone.

#_EVENTTIMES_LOCAL{...}

Sames as #_EVENTTIMES_LOCAL but displays custom format by replacing ... with documented Moment JS formatting syntax.

#_EVENTDATES_LOCAL

Sames as #_EVENTDATES but displays dates relative to your site timezone (dates can be different for events near midnight in a different timezone).

#_EVENTDATES_LOCAL{...}

Sames as #_EVENTDATES_LOCAL but displays custom format by replacing ... with documented Moment JS formatting syntax.

Links/URLs

#_EVENTIMAGEURL

Shows the event image url, if available.

#_EVENTURL

Simply prints the event URL. You can use this placeholder to build your own customised links.

#_EVENTLINK

Displays the event name with a link to the event page.

#_EDITEVENTLINK

Inserts a link to the admin or buddypress (if activated) edit event page, only if a user is logged in and is allowed to edit the event.

#_EDITEVENTURL

Inserts a url to the admin or buddypress (if activated) edit event page, only if a user is logged in and is allowed to edit the event.

Custom Attributes

Events Manager allows you to create dynamic attributes to your events, which act as extra information fields for your events (e.g. "Dress Code"). For more information see our online documentation for more info on attributes.

#_ATT{key}

This key will appear as an option when adding attributes to your event.

#_ATT{key}{alternative text}

This key will appear as an option when adding attributes to your event. The text in the second braces will appear if the attribute is not defined or left blank for that event.

#_ATT{key}{option 1|option 2|option 3|etc.}

This key will appear as an option when adding attributes to your event. The second braces are optional and will use a select box with these values as input. If no valid value is defined, the first option is used.

Bookings

These placeholders will only show if bookings are enabled for the given event and in the events manager settings page. Spaces placeholders will default to 0

#_BOOKINGFORM

Adds a booking forms for this event.

#_BOOKINGBUTTON

A single button that will appear to logged in users, if they click on it a booking will be made. This button will automatically book the first aailable ticket if more than one ticket exists for the event, and will also circumvent any payment requirements. Use in combination with conditional placeholders such as is_free to avoid unpaid bookings.

#_AVAILABLESPACES

Shows available spaces for the event.

#_BOOKEDSPACES

Shows the amount of currently booked spaces for the event.

#_PENDINGSPACES

Shows the amount of pending spaces for the event.

#_SPACES

Shows the total spaces for the event.

#_ATTENDEES

Shows the list of user avatars attending the event.

#_ATTENDEESLIST

Shows the list of people attending the event.

#_ATTENDEESPENDINGLIST

Shows the list of people with a pending booking for the event.

#_BOOKINGSURL

Shows the url to the admin, front-end or buddypress (if activated) bookings management page for this event. Only shown if user is logged in and able to manage bookings.

#_BOOKINGSLINK

Shows a link to the admin, front-end or buddypress (if activated) bookings management page for this event. Only shown if user is logged in and able to manage bookings.

#_EVENTPRICERANGE

Shows a "maximum - minimum" price range for available tickets at the time of display, or a single price if there is no range. Once bookings are closed this will show a 0 value, if you have enabled 'Show unavailable tickets' in your booking settings these will be included. Price is formatted according to currency formatting in your settings page.

#_EVENTPRICERANGEALL

Like #_EVENTPRICERANGE but shows all tickets price range whether or not bookings or individual tickets are available.

#_EVENTPRICEMIN

Shows the lowest available ticket price for this event. Will display a value of 0 if no ticket is available.

#_EVENTPRICEMAX

Shows the highest available ticket price for this event. Will display a value of 0 if no ticket is avaialble.

#_EVENTPRICEMINALL

Shows the lowest ticket price for this event, whether available or not.

#_EVENTPRICEMAXALL

Shows the highest ticket price for this event, whether available or not.

Contact Details

The values here are taken from the chosen contact for the specific event, or the default contact in the settings page.

#_CONTACTNAME

Name of the contact person for this event (as shown in the dropdown when adding an event).

#_CONTACTUSERNAME

Contact person's username.

#_CONTACTEMAIL

E-mail of the contact person for this event.

#_CONTACTURL

Website of the contact person for this event.

#_CONTACTPHONE

Phone number of the contact person for this event. Can be set in the user profile page.

#_CONTACTAVATAR

Contact person's avatar.

#_CONTACTPROFILELINK

Contact person's "Profile" link. Only works with BuddyPress enabled.

#_CONTACTPROFILEURL

Contact person's profile url. Only works with BuddyPress enabled.

#_CONTACTID

Contact person's WordPress user ID.

#_CONTACTMETA

Display any user meta of a WordPress account by including the meta key, e.g. #_CONTACTMETA{dbem_phone}

iCal/Calendar

#_EVENTICALURL

Displays the URL of the event ical feed (ics file format).

#_EVENTICALLINK

Displays an html link to the event ical feed (ics file format).

#_EVENTWEBCALURL

Same as #_EVENTICALURL, but using the webcal:// protocol, which will open up various calendar apps automatically including iCalendar, Outlook and Google Calendar.

#_EVENTWEBCALLINK

Same as #_EVENTICALLINK, but using the webcal:// protocol, which will open up various calendar apps automatically including iCalendar, Outlook and Google Calendar.

#_EVENTGCALURL

Displays URL which would take the user to Google Calendar and pre-fill their add new event form.

#_EVENTGCALLINK

Displays a button which would take the user to Google Calendar and pre-fill their add new event form.

Location Details

#_LOCATIONID

Shows the event ID number in the wp_em_locations table.

#_LOCATIONPOSTID

Shows the location corresponding Post ID in the wp_posts table.

#_LOCATIONNAME

Displays the location name.

#_LOCATIONADDRESS

Displays the address.

#_LOCATIONTOWN

Displays the town.

#_LOCATIONSTATE

Displays the state/county.

#_LOCATIONPOSTCODE

Displays the postcode.

#_LOCATIONREGION

Displays the region.

#_LOCATIONCOUNTRY

Displays the country.

#_LOCATIONLONGITUDE

Displays the longitude, used for locating in Google Maps.

#_LOCATIONLATITUDE

Displays the latitude, used for locating in Google Maps.

#_LOCATIONMAP

Displays a google map showing where the location is located (Will not show if maps are disabled in the settings page)

#_LOCATIONNOTES

Shows the location description.

#_LOCATIONEXCERPT

If an excerpt has been added to the location, it will be used. If you added a more tag to your location description, only the content before this tag will show.

#_LOCATIONEXCERPT{words, ...}

If an excerpt has not been added to the location, only a specific length is shown, e.g. #_EVENTEXCERPT{10,...} where 10 is the number of words to show and ... is what is used at the cut-off point.

#_LOCATIONEXCERPTCUT

Same as #_LOCATIONEXCERPT (and also accepts the {words,...} arguments) but will also cut excerpts as well as post content. Default word limit is 55 and cut-off is [...]

#_LOCATIONIMAGE

Shows the location image.

#_LOCATIONIMAGE{x,y}

Shows the location image thumbnail, x and y are width and height respectively, both being numbers e.g. #_LOCATIONIMAGE{100,100}. If 0 is used for either width or height, the corresponding dimension will be proportionally sized.

#_LOCATIONIMAGEURL

Shows the location image url, if available.

#_LOCATIONFULLLINE

Shows a comma-separated line of location information, ommitting blanks (format of address, town, state, postcode, region

#_LOCATIONFULLBR

Shows a line-break (br tag) separated location information, ommitting blanks (format of address, town, state, postcode, region

Custom Attributes

Events Manager allows you to create dynamic attributes to your locations, which act as extra information fields for your locations (e.g. "Dress Code"). For more information see our online documentation for more info on attributes.

#_LATT{key}

This key will appear as an option when adding attributes to your location.

#_LATT{key}{alternative text}

This key will appear as an option when adding attributes to your location. The text in the second braces will appear if the attribute is not defined or left blank for that location.

#_LATT{key}{option 1|option 2|option 3|etc.}

This key will appear as an option when adding attributes to your location. The second braces are optional and will use a select box with these values as input. If no valid value is defined, the first option is used.

Links

#_LOCATIONURL

Simply prints the location URL. You can use this placeholder to build your own customised links.

#_LOCATIONLINK

Displays the location name with a link to the location page.

#_EDITLOCATIONLINK

Inserts a link to the admin or buddypress (if activated) edit location page, only if a user is logged in and is allowed to edit the location.

#_EDITLOCATIONURL

Inserts a url to the admin or buddypress (if activated) edit location page, only if a user is logged in and is allowed to edit the location.

Related Events

You can show lists of other events that are being held at this location. The formatting of the list is the same as a normal events list.

#_LOCATIONPASTEVENTS

Will show a list of all past events at this location.

#_LOCATIONNEXTEVENTS

Will show a list of all future events at this location.

#_LOCATIONALLEVENTS

Will show a list of all events at this location.

#_LOCATIONNEXTEVENT

Will show a link to the next event at this location, or the no events message.

iCal/RSS Feeds

#_LOCATIONICALURL

Displays the URL of the location ical feed (ics file format) which shows all events happening at that location.

#_LOCATIONICALLINK

Displays an html link to the event ical feed (ics file format) which shows all events happening at that location.

#_LOCATIONWEBCALURL

Same as #_LOCATIONICALURL, but using the webcal:// protocol, which will open up various calendar apps automatically including iCalendar, Outlook and Google Calendar.

#_LOCATIONWEBCALLINK

Same as #_LOCATIONICALLINK, but using the webcal:// protocol, which will open up various calendar apps automatically including iCalendar, Outlook and Google Calendar.

#_LOCATIONRSSURL

Displays the URL of an RSS feed showing all upcoming events happening at this location.

#_LOCATIONRSSLINK

Displays an html link to an RSS feed showing all upcoming events happening at this location.

Individual Booking Information

When a specific booking is displayed (on screen and on email), you can use these placeholders to show specific information about the booking. Event and Location placeholders are also available in these cases.

#_BOOKINGID

The unique ID of this booking, useful if you are making your own customizations to this plugin.

#_BOOKINGNAME

Name of person who made the booking.

#_BOOKINGEMAIL

Email of person who made the booking.

#_BOOKINGPHONE

Phone number of person who made the booking.

#_BOOKINGSPACES

Number of spaces the person has booked.

#_BOOKINGCOMMENT

Any specific comments made by the person who made the booking.

#_BOOKINGTICKETNAME

Name of the ticket booked. Useful in single ticket mode, if multiple tickets are booked a random ticket is used.

#_BOOKINGTICKETDESCRIPTION

Description of the ticket booked. Useful in single ticket mode, if multiple tickets are booked a random ticket is used.

#_BOOKINGTICKETPRICE

Booked ticket price with currency symbol (e.g. $ 10.00). Useful in single ticket mode, if multiple tickets are booked a random ticket is used.

#_BOOKINGTICKETS

A list of booked tickets. You can modify this by using template files and modifying templates/emails/bookingtickets.php

#_BOOKINGSUMMARY

Shows a breakdown of price/quantity booked by ticket, followed by a summary of price totals, taxes, and other discounts applied.

#_BOOKINGFORMCUSTOM{field_id}

(pro only) Shows booking form custom fields. The field_id value must match that of your custom booking form field.

#_BOOKINGFORMCUSTOMREG{field_id}

(pro only) Shows booking form custom fields that are used for guest user registration. The field_id value must match that of your custom booking form field.

#_BOOKINGFORMCUSTOMFIELDS

(pro only) Generates a list of booking form custom fields that are used in the booking.

#_BOOKINGATTENDEES

(pro only) Generates a list of attendee information displaying the filled in form data for each attendee (requires individual attendee forms enabled for the event). This list is split by ticket type, then by individual attendee.

#_BOOKINGADMINURL

URL for admins to view and manage the booking. This should only be used on admin-specific email templates.

#_BOOKINGADMINLINK

HTML link for admins to view and manage the booking. This should only be used on admin-specific email templates.

Pricing Information

#_BOOKINGPRICE

Displays booking total price (tax inclusion depends on your booking settings).

#_BOOKINGPRICETAX

Displays booking total tax.

#_BOOKINGPRICEWITHOUTTAX

Displays booking total without tax.

#_BOOKINGPRICEWITHTAX

Displays booking total with tax.

Ticket Information

#_BOOKINGTICKETS

Shows a breakdown of tickets and pricing, defined in the emails/bookingtickets.php template. (See Using Template Files for more information)

#_BOOKINGTICKETDESCRIPTION

Shows the description of the first ticket booked (useful in single ticket mode/events).

#_BOOKINGTICKETPRICE

Shows the price of the first ticket booked, tax inclusion depending on your booking settings (useful in single ticket mode/events).

#_BOOKINGTICKETTAX

Shows the tax of the first ticket booked (useful in single ticket mode/events).

#_BOOKINGTICKETPRICEWITHTAX

Shows the price including tax of the first ticket booked (useful in single ticket mode/events).

#_BOOKINGTICKETPRICEWITHOUTTAX

Shows the price excluding tax of the first ticket booked (useful in single ticket mode/events).

Links

People are able to manage their bookings. Below are some placeholder which automatically provides correctly formatted urls

#_BOOKINGLISTURL

URL to page showing that users booked events.

Gateway-Specific Information

Information pertaining to speicifc gateways. Requires Events Manager Pro

#_BOOKINGTXNID

Online Payments Only - Prints the transaction ID of this booking if available.

Coupon Information

When a booking has been made with a coupon, you can display coupon information using these placeholders. If no coupon is used, nothing will be shown. Requires Events Manager Pro

#_BOOKINGCOUPON

Displays the coupon code followed by the amount/percentage discounted.

#_BOOKINGCOUPONCODE

Displays the coupon code used.

#_BOOKINGCOUPONNAME

Displays the name given to this coupon.

#_BOOKINGCOUPONDISCOUNT

Displays amount/percentage discounted (e.g. 25% Off).

#_BOOKINGCOUPONDESCRIPTION

Displays the coupon description.

Category Details

You can use these when displaying categories or for showing the first available category in an event format.

#_CATEGORYNAME

Shows the category name.

#_CATEGORYID

Shows the category ID.

#_CATEGORYSLUG

Shows the category slug.

#_CATEGORYLINK

Category name with a link to the category page.

#_CATEGORYURL

URL of the category page.

#_CATEGORYCOLOR

Shows the category color (useful for inline styling), in hex format, if no color is defined the default category color from your settings page will be used.

#_CATEGORYIMAGE

Shows the category image, if available.

#_CATEGORYIMAGE{x,y}

Shows the category image thumbnail if available, x and y are width and height respectively, both being numbers e.g. #_CATEGORYIMAGE{100,100}. If 0 is used for either width or height, the corresponding dimension will be proportionally sized.

#_CATEGORYIMAGEURL

Shows the category image url, if available.

#_CATEGORYNOTES

Shows the category description.

Related Events

You can show lists of other events belonging to this category. The formatting of the list is the same as a normal events list.

#_CATEGORYPASTEVENTS

Will show a list of all past events with this category.

#_CATEGORYNEXTEVENTS

Will show a list of all future events with this category.

#_CATEGORYALLEVENTS

Will show a list of all events with this category.

#_CATEGORYNEXTEVENT

Will show the next event with this category.

iCal/RSS Feeds

#_CATEGORYICALURL

Displays the URL of the event ical feed (ics file format) which shows all events with this category.

#_CATEGORYICALLINK

Displays an html link to the event ical feed (ics file format) which shows all events with this category.

#_CATEGORYWEBCALURL

Same as #_CATEGORYICALURL, but using the webcal:// protocol, which will open up various calendar apps automatically including iCalendar, Outlook and Google Calendar.

#_CATEGORYWEBCALLINK

Same as #_CATEGORYICALLINK, but using the webcal:// protocol, which will open up various calendar apps automatically including iCalendar, Outlook and Google Calendar.

#_CATEGORYRSSURL

Displays the URL of an RSS feed showing all upcoming events happening in this category.

#_CATEGORYRSSLINK

Displays an html link to an RSS feed showing all upcoming events happening in this category.

Tag Details

You can use these when displaying tags or for showing the first available tag in an event format.

#_TAGNAME

Shows the tag name.

#_TAGID

Shows the tag ID.

#_TAGSLUG

Shows the tag slug.

#_TAGLINK

Tag name with a link to the tag page.

#_TAGURL

URL of the tag page.

#_TAGNOTES

Shows the tag description.

#_TAGCOLOR

Shows the tag color (useful for inline styling), in hex format, if no color is defined the default tag color from your settings page will be used.

#_TAGIMAGE

Shows the tag image, if available.

#_TAGIMAGE{x,y}

Shows the tag image thumbnail if available, x and y are width and height respectively, both being numbers e.g. #_TAGIMAGE{100,100}. If 0 is used for either width or height, the corresponding dimension will be proportionally sized.

#_TAGIMAGEURL

Shows the tag image url, if available.

Related Events

You can show lists of other events belonging to this tag. The formatting of the list is the same as a normal events list.

#_TAGPASTEVENTS

Will show a list of all past events with this tag.

#_TAGNEXTEVENTS

Will show a list of all future events with this tag.

#_TAGALLEVENTS

Will show a list of all events with this tag.

#_TAGNEXTEVENT

Will show the next event with this tag.

iCal/RSS Feeds

#_TAGICALURL

Displays the URL of the event ical feed (ics file format) which shows all events with this tag.

#_TAGICALLINK

Displays an html link to the event ical feed (ics file format) which shows all events with this tag.

#_TAGWEBCALURL

Same as #_TAGICALURL, but using the webcal:// protocol, which will open up various calendar apps automatically including iCalendar, Outlook and Google Calendar.

#_TAGWEBCALLINK

Same as #_TAGICALLINK, but using the webcal:// protocol, which will open up various calendar apps automatically including iCalendar, Outlook and Google Calendar.

#_TAGRSSURL

Displays the URL of an RSS feed showing all upcoming events happening in this tag.

#_TAGRSSLINK

Displays an html link to an RSS feed showing all upcoming events happening in this tag.