Events List Block

With Princeton Site Builder you can create a listing of events for your website.

Requires Events A collection of features or functionality that can be enabled on sites. WDS has made several optional modules available to site administrators to enable on their site. For example, the "News" module enables the News content type and provide a News List Block for displaying news on a page.

The Events module must first be enabled on your site to use this block.


  • Display a list of events from the Event A collection of fields that describe a specific type of content, like a news article, a person, or an event. Site admins can add additional content types by enabling optional modules. WDS can also create custom content types for a site. .
  • Select specific events to display or have the list generated automatically based on filters.
  • Order the events by date or title.
  • Control the number of events to display and optionally add a pager if you have many events.
  • Toggle which fields (date, summary, featured image, etc) to output for each event.
  • Optionally display a date "badge" instead of fully written out date.
  • Display upcoming events only, past events only, or both.
  • Filter events by Used primarily for categorizing content, a vocabulary defines a specific grouping of taxonomy terms. Some default vocabularies exist on all sites, but WDS can create custom vocabularies if needed. Synonymous with categories. and optionally expose those filters to the visitor so they can choose how to filter.
  • Display the events in either a grid or standard vertical list.

Upcoming Events and Events Archives

There are two common needs when displaying events on a site. One is to display a list of upcoming events only, and the other is to display an archive of all past events.

The Events List Block is used for both purposes.

For upcoming events, you just need to set the "Date Filtering" option to "Show only upcoming events". This is the default value for all events list blocks. A block of this type is commonly displayed on a main events page for your site.

For events archives, the "Date Filtering" option should be set to "Show only past events". The pager should be enabled as well, as there may be many past events that exceed the maximum limit for one page.

It's best to create a separate page for your events archive so that it's clear to your visitors that they're browsing a list of all past events only.

It may also be helpful to add an Events Archive Years List block to the same page, to allow visitors to quickly filter the events archive list by year.