Filter Bar

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

Rock Concert

January 22 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 United States

Rock Concert

February 1 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 United States

[ecs-list-events design="calendar" filterbar="true"]

Loading...

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

Loading...

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

Loading...

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

Rock Concert

January 22 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 United States

Rock Concert

February 1 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 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"]

Rock Concert

January 22 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 United States

Rock Concert

February 1 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 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"]

Rock Concert

January 22 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 United States

Rock Concert

February 1 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 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!