Pre-requisites: Meta keys require a block theme, block templates and to access the Site Editor.
Works for both EventKoi and EventKoi Lite.
These are not WordPress custom fields. They are binding keys used inside block templates, and they are not stored as post meta, so they cannot be read by anything that expects a custom field. In particular, SEO plugins will not resolve them: %customfield(event_datetime)% in Rank Math, or %%cf_event_datetime%% in Yoast, will always come back empty, because event dates are calculated when the page is rendered rather than saved to the database. Use the SEO variables in the next section instead.
Event dates in SEO titles and descriptions
From EventKoi 1.4.0, Rank Math and Yoast SEO get their own set of EventKoi variables. Type them into an event’s SEO title or meta description, or into the default template for events under your SEO plugin’s settings, and the plugin fills them in with the same values the event page shows.
%eventkoi_datetime%– the event’s date and time, for example September 1, 2026, 12:00 pm – 1:00 pm%eventkoi_datetime_with_summary%– the date and time followed by the recurrence summary, for a recurring event%eventkoi_date%– the date only%eventkoi_time%– the time only%eventkoi_recurrence%– the recurrence summary, for example Repeats every week on Tuesday%eventkoi_location%– the event location%eventkoi_timezone%– the timezone the event is shown in
For example, a Rank Math meta description of Join us on %eventkoi_datetime% at %eventkoi_location%. becomes Join us on September 1, 2026, 12:00 pm – 1:00 pm at Quincy Community Center. A variable that has nothing to show, such as the location on an event without one, comes out empty rather than as placeholder text.
The same variable names work in both Rank Math and Yoast SEO, and in both EventKoi and EventKoi Lite. They are only available on event pages.
With EventKoi, you can create dynamic event templates in the site editor using our meta keys. You can add any meta key into an event template and it will dynamically pull the correct information based on the relevant event.
This works very similarly to shortcodes, but with the added ability to format the meta keys (e.g. change the text size and colour).
It can only be used with the heading, paragraph, button, and image blocks. So, for example, you cannot use the event_image meta key with the cover image block.
Complete list of meta keys from EventKoi:
- event_title
- event_details
- event_timezone
- event_gmap
- event_image
- event_image_url
- event_calendar_url
- event_calendar
- event_calendar_link
- event_location
- event_datetime_with_summary
- event_datetime
- event_date_type
- event_rulesummary
- ticket_rsvp
For custom fields
Display all filled out custom fields: event_custom_fields_with_name or event_custom_fields
For individual custom fields or groups, head to Settings > Custom fields and look for the field ID. The ID is the meta key.
You can add with_name to the end of any custom field ID to also display the name of the custom field.
Where to use meta keys in the block editor
You have the option of customising the default events template. This will allow you to change how all events are displayed. This is handy if you want to customise your events template at a global level.
Alternatively, you can create your own template to use on individual events. This is handy if you have an event that needs a different design from your default events template.
Learn how to customise the default events template here: