Creating Events

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.

Installing Add-ons

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.

Contents

Individual events

Create new events at Content > Add Content > Event (/node/add/utevent_event).

Recurring events

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).

Screenshot of the Event date widget showing Repeat dropdown, "Manage instances" and "Add another item" buttons

Event date widget showing Repeats dropdown, “Manage instances” and “Add another item” buttons

Controlling image display with “Display image on event”

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.

Screenshot of the "Display image on event" checkbox

Screenshot of the “Display image on event” checkbox

Summary and Body fields

The Summary field displays in lists of events. The Body field displays on the individual event page.

Location field

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.

Event status field

The Event Status field calls out the state of the event:

  • “Scheduled” (default)

  • “Cancelled”

  • “Moved Online”

  • “Postponed”

  • “Rescheduled”

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.

Events listing page

All published upcoming events display the site at /events, as shown below:

Screenshot showing the Events listing page.

Users with the permission “Administer event configuration” can navigate to Configuration > Event Feature (/admin/config/content/utevent) for configuring the page title.

Event listing blocks

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 (/events).

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:

  1. Create a Flex Page.

  2. Navigate to that page’s Layout tab.

  3. Choose Add block in the region the list should appear

  4. 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 (/admin/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.

Screenshot showing Location, "Event tags" and "Featured event" fields for filtering event listing blocks

Location, “Event tags” and “Featured event” fields for filtering event listing blocks