Add a filter bar to the top to let visitors refine what events are displayed by category, tag, venue, country, state/province, city, and date.
The filter bar option is included in The Events Calendar Shortcode & Block!
Custom Filters
Use Additional Fields from Events Calendar Pro, or create your own custom filters.
Display options
Change the order the filters are displayed in, and which filters you want to show.
Responsive Design
The filter bar is responsive and will adjust to the width of the screen.
Demos
[ecs-list-events filterbar="true" filterorder="country, state, city, tag, category, venue, fromdate, todate" fromdate="today"]
Farmer’s Market
December 23 - December 24Lahaina, 96761 United States
Kitten Adoption Day
January 1, 2025San Jose, 95128 United States
[ecs-list-events design="calendar" filterbar="true"]
Change Filter Order
Use the filterorder option to change what order filters are displayed.
[ecs-list-events design="calendar" filterbar="true" filterorder="country, state, tag, category, venue"]
Hide Filter Options
Omit filter(s) from the filterorder option to remove them from the display completely.
Filters available are:
- country - Country
- state - State/Province
- category - Category
- venue - Venue
- tag - Tag
- fromdate - Starting date
- todate - Ending date
[ecs-list-events design="calendar" filterbar="true" filterorder="category, state"]
Change Filter Titles
Alter the title of any filter with the filterbar-(filter name)-title option (venue, category, state, country, tag, fromdate).
- filterbar-country-title - Country
- filterbar-state-title - State/Province
- filterbar-category-title - Category
- filterbar-venue-title - Venue
- filterbar-tag-title - Tag
- filterbar-fromdate-title - Events From
- filterbar-todate-title - Events To
[ecs-list-events filterbar="true" filterbar-category-title="My Category Title" filterbar-venue-title="Location" filterbar-tag-title="Event Tag" filterbar-fromdate-title="Starting Date" filterbar-todate-title="Ending Date" filterorder="category, venue, state, country, tag, fromdate" fromdate="today"]
Farmer’s Market
December 23 - December 24Lahaina, 96761 United States
Kitten Adoption Day
January 1, 2025San Jose, 95128 United States
Change Available Filter Values
Alter the values available with a filter with the filterbar-(filter name) option (venue_id, cat, state, country, tag).
- filterbar-country - Country
- filterbar-state - State/Province
- filterbar-cat - Category
- filterbar-venue_id - Venue
- filterbar-tag - Tag
>[ecs-list-events filterbar="true" filterbar-country="United States, France" filterbar-venue_id="33" filterbar-tag="community, outdoor" filterbar-state="CA, IL, MO" filterbar-cat="meeting, nightlife"]
Farmer’s Market
December 23 - December 24Lahaina, 96761 United States
Kitten Adoption Day
January 1, 2025San Jose, 95128 United States
Change Date Format
Use the filterbar-dateformat option to change how the date fields (Events From, Events To) appears.
[ecs-list-events design="default" filterbar="true" filterbar-dateformat="dd/mm/yy" filterorder="fromdate, todate" fromdate="today"]
Farmer’s Market
December 23 - December 24Lahaina, 96761 United States
Kitten Adoption Day
January 1, 2025San Jose, 95128 United States
Additional Fields from Events Calendar PRO
You can filter by any of the Additional Fields you've set up for your events! More detail here.
Use With Other Designs
In addition to the Calendar and Default designs shown above, the filter can also be used with the Compact, Columns/Photo, Table and Grouped designs!