Skip to content
Tickets Please

Events Bar

Events Bar

The Events Bar is the toolbar that appears above every calendar view. It gives visitors three tools in one compact row: keyword search, date filtering, and view switching. Every interaction updates the URL with GET parameters, so filtered results are bookmarkable and shareable.

The keyword search field searches across event titles, content, and excerpts. Type a term and press Enter or click the search button. Results update to show only events matching the query.

The search parameter appears in the URL as ?s=your+search+term. You can link directly to a pre-filtered search by constructing the URL manually, for example: yoursite.com/events/?s=workshop.

Date Picker

The date picker lets visitors jump to a specific date or narrow results to a date range. Click the date field to open a calendar dropdown, pick a date, and the view updates to show events starting from that date.

Two URL parameters control date filtering:

  • start_date — show events on or after this date (format: YYYY-MM-DD)
  • end_date — show events on or before this date (format: YYYY-MM-DD)

You can use both together to define a window. For example, ?start_date=2026-03-01&end_date=2026-03-31 shows all March events.

Category and Tag Filters

The Events Bar also accepts category and tag filters via URL parameters:

  • category — filter by event category slug (e.g., ?category=workshops)
  • tag — filter by event tag slug (e.g., ?tag=outdoor)

These parameters stack with search and date filters. A URL like ?s=bird&category=workshops&start_date=2026-06-01 finds workshop events about birds starting in June.

View Switcher

Three buttons in the Events Bar let visitors toggle between List, Month, and Day views. Clicking a button navigates to the corresponding view URL while preserving any active search or filter parameters.

The current view is visually highlighted so visitors always know which layout they are looking at.

Combining Filters

All filter parameters work together and persist across view switches. If a visitor searches for “photography” in List view and then switches to Month view, the month grid shows only photography events.

The full set of supported GET parameters:

ParameterDescriptionExample
sKeyword search?s=photography
start_dateEvents on or after this date?start_date=2026-04-01
end_dateEvents on or before this date?end_date=2026-04-30
categoryEvent category slug?category=classes
tagEvent tag slug?tag=beginner

Bookmarkable URLs

Every combination of filters produces a clean, shareable URL. If you want to link to “all outdoor workshops in July” from a blog post or email newsletter, construct the URL with the appropriate parameters and the link will always return the same filtered view.

Enabling and Disabling the Events Bar

The search bar within the Events Bar is controlled by the Enable event search toggle under Events > Settings > Display. Turning this off hides the keyword search field but keeps the date picker and view switcher visible.

To hide the entire Events Bar, use CSS in your theme or the tickets_please_events_bar_enabled filter in your functions.php.

Common Questions

Can I add custom filters to the Events Bar? The Events Bar renders its components through templates that you can override in your theme. For custom filter dropdowns, copy the Events Bar template to your theme’s tribe/events/v2/ directory and add your markup.

How do I link directly to a filtered view? Construct a URL with the GET parameters listed above. For example, yoursite.com/events/list/?s=concert&start_date=2026-05-01 links to a list of concerts starting in May.

Does the search include venue names? The keyword search covers event titles, content, and excerpts. Venue names are not included in the default search. If a venue name appears in the event content or excerpt, it will match.

Can I set a default date range? Not through the admin settings. The default behavior shows all upcoming events with no end-date cutoff. You can set a default range by pre-populating the URL parameters in your theme’s events page link.

Can I hide the view switcher? Yes. Override the Events Bar template in your theme and remove the view switcher markup, or hide it with CSS targeting the view switcher container.

Next Steps