Event Types (Archetypes)
FreeSince 7.1Included in the free Events Manager plugin.
An archetype is a type of event. Out of the box there is one, called Events. You can add more, for example Workshops, Appointments or Webinars, and each gets its own menu in wp-admin, its own web address and its own settings, while bookings, locations and placeholders keep working the same way for all of them.
Add a type when a group of events needs to be managed or presented apart from the rest: paid courses kept separate from free community events, or appointments with their own emails and booking rules. If all you need is a label on events so visitors can filter them, use categories instead.
You can also use this screen without adding anything, to rename Events and Locations to words that suit your site.
The settings screen marks archetypes as a beta feature. The options that can be set separately for each type are expected to grow.
Where event types are managed
Everything is in Events then Settings then General then Events Types (Archetypes), the first box on the tab.
Base Event Settings, the builder for your own types, and Base Location Settings.
| Section | What it is for |
|---|---|
| Base Event Settings | Rename the built-in event type and change its web address. |
| Archetypes UI Builder | Add, edit and delete your own event types. |
| Base Location Settings | Rename locations and change their web address. |
Rename events or locations
In Base Event Settings, or Base Location Settings for locations, change any of these and save.
| Field | What it changes |
|---|---|
| Label (Plural) and Label (Single) | What events are called in admin menus and screens, for example "Sessions" and "Session". |
| Permalink Slug | The part of the address that events sit under, such as events in yoursite.com/events/harbor-lights-jazz-night/. You can use / to make a longer path. |
| CPT (Single) and CPT (Plural) | The internal names WordPress stores the post type under. Click the pencil icon to edit them. |
| Admin Icon | The menu icon: a Dashicons class name or the address of a PNG or SVG image. Leave it empty for the default. |
Changing the Permalink Slug changes the address of every event, so set up redirects from the old addresses on a live site. Changing a CPT name can break other plugins or custom code that refer to the old name, and Events Manager asks you to confirm before it lets you. Most sites should rename the labels and leave the CPT names alone.
Add an event type
-
In Archetypes UI Builder, click Add New Archetype.
-
Fill in the fields:
Field Example Rules Label (Plural) Workshops Label (Single) Workshop Permalink Slug workshopsLowercase letters, numbers, hyphens and forward slashes. CPT (Single) workshopLowercase letters, numbers and underscores. It can't be a name WordPress or another plugin already uses. CPT (Plural) workshopsThe same rules. Admin Icon dashicons-hammerOptional. -
Click Save on the new type, then save the settings page.
The new type appears as its own top-level menu in wp-admin, next to Events, with its own list, its own Add screen and its own Bookings, Settings and Help items. Events of that type live at the slug you chose.
To change a type later, click Edit on it in the builder.
Delete removes the event type and every event of that type, with their bookings. It can't be undone. Back up your database first.
Give a type its own settings
Each type starts out using your normal Events Manager settings. To change some for one type only:
-
Open Settings from the type's own menu, or go to Events then Settings and click the type's name in the list above the tabs.
-
The screen now shows only the options that can differ for a type, with a note saying which type you are viewing. Change what you need. Options you leave alone keep following the main settings.
-
Save.
For groups of checkboxes, such as Location Types, two buttons choose between Use Defaults and Override Defaults.
What a type can override:
| Tab | Options |
|---|---|
| General | The default list scope, timezone support, event status, recurring and repeating events, bookings, tags, categories, attributes and custom fields, whether locations are used or required, and the location types. |
| Pages | The type's events page, how single events and archives are displayed, and its front-end management pages. |
| Formatting | The event list, grid, single event and excerpt formats, and the search form. |
| Emails | The booking emails, the event submission and approval emails, and the cancelled event email. |
So a Webinars type can have bookings on, locations limited to virtual ones, its own list layout and its own confirmation email, with nothing changed for your other events.
Show one type on the front end
Each type has its own events page and archive at its slug. Elsewhere, lists show the type you ask for:
- In a shortcode, add the
event_archetypeattribute with the type's CPT (Single) name:[events_list event_archetype="workshop"]. - In the Events List and Events Calendar blocks, choose the type in the block's settings.
See search attributes for the other filters you can combine with it.
Multisite networks
On a multisite network, the network admin's Events Manager settings have a Multisite Settings section at the top of the same box.
| Setting | What it does |
|---|---|
| Enable custom event archetypes? | Lets subsites have event types beyond the base one. |
| Subsite Archetype Mode | Allow subsites to create their own, Subsites choose from network list, or Force network-defined list (no subsite choice). |
| Rename Labels?, Rename Slugs?, Rename CPTs? | Whether site admins may rename the base event and location labels, slugs and CPT names on their own site. |
When subsites choose from the network's list, each subsite sees an Available Archetypes section where it ticks the types it wants and picks its default.
Turn the feature off
A developer can remove the ability to add event types by defining a constant. The built-in event and location types are unaffected.
define( 'EM_CUSTOM_ARCHETYPES', false );
Troubleshooting
The new type's pages give a "not found" error
Open Settings then Permalinks and click Save Changes to refresh the site's address rules, then try again. Check also that the slug is not already used by a page.
The CPT name is rejected
It must be lowercase, without spaces, and not already in use by WordPress or another plugin. WordPress also limits post type names to 20 characters.
An option I want to change for one type is not shown
Only some options can be set per type. Anything not shown on the type's settings screen is shared by all types.