Skip to content
Tickets Please

Calendar Views

Calendar Views

Visitors to your site need different ways to browse events. Someone scanning for this weekend’s activities wants a quick list; someone planning months ahead wants a calendar grid. Tickets Please ships three built-in views so you can serve both without installing anything extra.

List View

The List view is the default. It shows upcoming events in a paginated, chronological list at /events/ or /events/list/.

Each entry displays:

  • Event date and time
  • Event title (linked to the single event page)
  • Venue name
  • Excerpt (the first portion of the event description)
  • Featured image thumbnail

Pagination follows the pattern /events/list/page/2/, /events/list/page/3/, and so on. The number of events per page is controlled by a single global setting under Events > Settings > General (default: 10).

List view is the best starting point for most sites. It works well on all screen sizes, loads quickly, and gives visitors the most information at a glance.

Month View

The Month view renders a traditional calendar grid at /events/month/. Each day cell shows events as compact labels or dots. Hovering over a day reveals a tooltip with event names and times.

  • Today’s date is highlighted automatically.
  • Navigate between months using the forward and back arrows, or jump directly to a specific month via the URL pattern /events/month/2026-03/.
  • Days with events are clickable and link to the Day view for that date.

Month view is ideal for venues, community centers, and organizations where visitors want to see event density at a glance.

Day View

The Day view displays all events for a single date at /events/day/. Events are laid out in a time-slot format, ordered by start time, making it easy to see what is happening and when.

Navigate between days with the forward and back arrows, or go directly to a date using /events/day/2026-02-15/.

Day view works well for conferences, multi-event venues, and any situation where a single day has several overlapping events.

Setting the Default View

Go to Events > Settings > Display and choose which view visitors see when they land on your events page. The options are List, Month, or Day.

Regardless of the default, visitors can switch between views at any time using the view switcher in the Events Bar. The URL updates to reflect the active view, so bookmarked links always return to the correct layout.

Events Per Page

The events-per-page setting under Events > Settings > General controls how many events appear before pagination kicks in. This setting applies globally across all views. The default is 10.

In Month view, this setting does not affect the grid itself (the grid always shows the full month), but it limits how many events appear in day-cell tooltips and expanded day panels.

Overriding View Templates

If your theme needs to customize the HTML output for any view, copy the template files from the plugin’s templates/ directory into a tribe/events/v2/ directory in your theme. Tickets Please checks for theme overrides before falling back to its own templates.

For example, to customize the list view:

  1. Create wp-content/themes/your-theme/tribe/events/v2/ if it does not exist.
  2. Copy the relevant template file from the plugin into that directory.
  3. Edit the copy. Your version takes priority.

This follows the same template override pattern used by WooCommerce and other major WordPress plugins.

Common Questions

Can I set a different default view for different pages? The default view is a global setting. If you need different views on different pages, use the shortcode or block for each view type and place them on separate pages manually.

How do I change the number of events shown per page? Go to Events > Settings > General and update the events-per-page value. This applies to all views.

Can I hide certain views from visitors? Not with a built-in setting, but you can remove view options from the Events Bar using CSS or by filtering the output with the tickets_please_view_switcher_views hook in your theme’s functions.php.

Do past events appear in these views? By default, the List view shows only upcoming events. You can enable past events under Events > Settings > Display. Month and Day views always show events for the displayed date range regardless of this setting.

Can I embed a calendar view on a regular page? Yes. Use the Events List or Mini Calendar block in the block editor, or the corresponding shortcode, to embed event listings on any page or post.

Next Steps