The Events Calendar

Configuring Filter Bar

Learn how to configure filters, customize display orientation, and manage field order in the Filter Bar for The Events Calendar.

Access Filter Settings

Navigate to Events → Settings → Filters in your WordPress admin dashboard to manage all Filter Bar configurations.

This screen indicates that the settings for Filter Bar are located under Events, Settings, and the Filters tab.

Choose Layout and Default State

Configure how the filter interface appears to desktop and mobile visitors:

  • Filters Layout: Choose how filters sit relative to your calendar:
    • Horizontal: Displays directly above the calendar grid.
    • Vertical: Displays in a sidebar alongside the calendar.
  • Filters Default State (Horizontal only): Choose whether the horizontal bar loads Expanded (Open) or Collapsed (Closed) when the page first loads on desktop. If collapsed, visitors click a “Show Filters” button to reveal options.
  • Mobile Behavior: On mobile screens, the filter interface always remains collapsed by default to conserve screen space.
configure filter bar between vertical or horizontal layouts

Now, our filters will display next to the calendar vertically instead of above the calendar:

Enable and Order Filters

Checking and unchecking filters in the Available Filters panel has two effects:

  1. It adds or removes filters from the Active Filters box on the right.
  2. It controls which filter options visitors actually see on the front end of your calendar.

By default, only Event Category, Tags, Venue, Featured Events, and Cost are enabled. You can enable any of the following additional options:

Core & Standard Filters

  • Event Category: View only events in specific categories
  • Cost ($): View events within a certain price range
  • Tags: View only events that have certain tags
  • Venues: View events that are happening at specific venues
  • Organizers: View only events with certain organizers
  • Day: View only events on specific day(s) of the week
  • Time: View events that take place in a certain part of the day, e.g. Morning
  • Country: View events with venues in a particular country
  • City: View events with venues in a particular city
  • State/Province: View events with venues in a particular state or province
  • Featured Events: View Featured Events only
  • Event Status: View events marked as canceled or postponed.
  • Date Range – View events within a specific date range
  • Category Filter (Admin Configuration) – Pre-select which categories are available in the front-end filter 

Events Calendar Pro Filters

If you have both Filter Bar and Events Calendar Pro installed, you will see several additional options in the filters list:

  • Virtual Events: Activating this filter adds a radio button control with three options:
    • View all events (default)
    • View only virtual events
    • Hide virtual events(You will also see a Moved Online event status option if you have events marked with that status).
  • Distance: This filter appears whenever a visitor uses the Location search on any calendar view. Visitors can use it to narrow the initial search to a specific radius from that location.
    • You can change distance units (miles vs. kilometers) under Events → Settings → General → Map Settings.
    • Note: For the Distance filter to work properly, you must entera valid custom Google Maps API Key under Events → Settings → Integrations.
  • Series: This filter appears if you have configured at least one event series. Enabling it allows visitors to filter down to events grouped together in a series.

Note on Venues:

The options available to site visitors using the Country, City, or State/Province filters are defined by your published venues. The filters only include data from published venues that are assigned to a past, present, or future event. The information from venues that are not associated with any published events will not be used in the filters.

Configure Active Filters

Now that you’ve chosen which filters to include, you can configure how they display on your website by arranging them in the Active Filters panel.

You can choose in what order the filters will display. Click and drag each item to change their order.

how to configure filter bar by drag and drop sorting

Next, you can configure how each filter displays and behaves. Every filter in the Active Filters list can be expanded by clicking the down arrow to the right to reveal advanced options. For example, expanding the Cost ($) filter reveals options to change the display from a slider to checkboxes and whether to include free events in the filtered events.

Modify Filter Bar Active Filter Options

Make sure your venue locations have been validated by Google Maps in order for the filters to correctly appear in the options. This will avoid issues with states being listed as separate entries such as CA and California.

The Events Calendar has a built-in feature that checks for broken venue data and will correct it for you. If you head over to Events → Settings, there is a section called Map Settings and a button that says “Fix venue data.”

For more help with venue data, see Troubleshooting Map View.

Add Custom Fields

If you have Events Calendar Pro, any Additional Fields created under Events → Settings → Additional Fields automatically appear in your Filter Bar settings. For example, if you created a field like “Dress Code” or “Skill Level,” it will show up in the Available Filters panel ready to be enabled, ordered, and customized.

This is the additional fields filter bar settings

Notice the extra option to configure the Logic for this filter. This allows you to set a condition that filters events based on whether an event meets all the criteria of a user’s selection or any part of it. For example, if we had an event that was offered both Black Tie and Casual options for Dress Attire, then we could tell the Filter Bar to show all events related to either option or both of them.

Note that even if you add a Pro custom field to Filter Bar’s settings, it will not appear on the front end unless at least one of your events has a value set for this particular field.

Rename Filter Labels

When the Filter Bar is enabled, each filter has its own title (for example, “Events Category”). This generally works as expected, but when you translate your site into another language, not all parts of these titles may be translated automatically.

For example, you might translate your entire site into Russian and see that everything appears correctly translated, except for the word “category” in the “Events Category” filter, which may still display in English.

The titles are generated programmatically, so at this time you cannot fix the above issue with the translation files.

You can, however, fix the issue by overriding the title text completely in your Settings. Here’s how to do that:

  • From the WordPress dashboard, head to Events → Settings → Filters.
  • In the list of filters, find the filter whose title is not appearing how you would like (e.g. Category).
  • Expand the filter so that some options related to it expand, as shown in the image below.
  • Customize the title text so that it is in the language of your site. See below for a screenshot of where to customize this.
  • Save your changes, and you’re all set!
An example of the customizable “Title” field for Filter Bar filters.

Save Changes & Verify Front-End Display

Don’t forget to click the Save Changes button at the bottom of the screen when you’re done. This applies your new layout and active filters directly to your live calendar.

Filed under Setup
Last updated: November 11, 2026
Was this page helpful?
Thanks for the feedback!