Publicize upcoming events using the “Event” page type. Features:
Each event displays on its own page with title, description, date, location, image, and status.
Recurring events are supported.
Event pages include “Add to calendar” links that work with Outlook, Apple Calendar, and Google Calendar.
The “Upcoming Events” page (
/events) lists upcoming events.
The “All Events Calendar” (
/calendar) displays events by month.
“Event listing” blocks can display events by specific category.
Add-ons like Events are not included with the Drupal Kit by default. Read the Add-ons page for more information about how add to this feature to your site.
Create new events at Content > Add Content > Event (
When deciding how to create an event that occurs on multiple dates or times, identify whether the specifics of the event, aside from date and time, will differ.
For a recurring event that may have different event locations or descriptions on different dates, create a separate event for each occurrence. Examples: a lecture series featuring a different speaker for each lecture; a blood bank at a different location each week.
For a recurring event where location and description remain the same across all occurrences, create one event with a recurrence rule. Example: a standing appointment, like weekly office hours, that always happens in the same location.
If a recurring event has dates and times that do not follow a pattern, add multiple each occurrences using the “Add another item” button (shown below).
If a recurring event has dates and times that generally follow a pattern, you can use the “Repeats” dropdown to create a recurrence rule. A recurring event entered this way may include occurrences that happen at a date and time outside the recurrence rule. Set occurrence overrides by clicking “Manage instances” (shown below).
By default, event images will display on the individual event’s page, the “Events” page, and on any events listing blocks. To suppress the image on the individual event page, uncheck the “Display image on event” checkbox.
The Summary field displays in lists of events. The Body field displays on the individual event page.
The event Location field displays on event pages and lists. Content editors can also use these to filter events by location in event listing blocks, as explained below.
The Event Status field calls out the state of the event:
These states correspond to predefined metadata labels recognized and used by search engines. When an event has any status other than “Scheduled,” a visual cue will display alongside the event. Regardless of state, events will display on your site. For example, an event scheduled for tomorrow whose status has changed from “Scheduled” to “Cancelled” will still display in the listing, with a “Cancelled” visual.
If the status of an event changes, use the “Event status” field to reflect that status. As a rule of thumb, once published, an event should not be deleted or unpublished. Deleting a cancelled event risks confusing visitors who had previously viewed the event while it was active.
All published upcoming events display the site at
/events, as shown below:
Users with the permission “Administer event configuration” can navigate to Configuration > Event Feature (
/admin/config/content/utevent) for configuring the page title.
Many sites will need to display a subset of upcoming events alongside other page content. For example, a college/department site may want to list only faculty training events in the sidebar of the site’s faculty landing page. To achieve this, use Event listing blocks.
Each event listing block has Header and Footer fields for adding text above and below a list respectively. There is also a “Display link back to main events page” checkbox which toggles the presence of a “View all events” button at the bottom of a listing block. When present, this button links back to the main events list page (
Event listings can display in 1, 2, 3, or 4 items per row. See Control items per row (multi-item components) for more detail.
Sites usually only need to display event listings on individual pages:
Create a Flex Page.
Navigate to that page’s
Add blockin the region the list should appear
Select Create content block > Event listing in the settings tray.
Sometimes sites need a listing to display on multiple pages. To do this, go to Content > Blocks > Add content block > Event listing (
/block/add/utevent_event_listing). Once created, this event listing will be available in the Block library placed on existing pages. For example, page types with flexible layouts (like the Flex Page) will now show this as a placeable block in the settings tray.
Control which events display in a listing by adding “Event tags” or “Event location” filters. Accounts with elevate permissions can manage event tags and locations at Structure > Taxonomy (
The “Featured event” checkbox provides an additional way to create targeted event listings for, say, the site homepage.
Reminder: Content editors must assign tags to individual events to make them function as filter criteria on listings.