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! You can enable the filter bar using the block settings, or with shortcodes like the ones below. There's the choice of either a horizontal or vertical layout.

Demos

[ecs-list-events filterbar="true" filterbar-layout="vertical" filterorder="country, state, city, tag, category, venue, fromdate, todate, search, cost" fromdate="today" cost="yes"]

[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" filterbar-layout="vertical"]

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" filterbar-layout="vertical"]

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" filterbar-layout="vertical"]

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"]

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!