The Events Calendar Shortcode & Block



Get your events displayed in a customizable list wherever you need them, with The Events Calendar Shortcode and Block! This plugin fully integrates with The Events Calendar Plugin (free version) by Modern Tribe.

This plugin adds a shortcode and a WordPress block for use with The Events Calendar WordPress Plugin (by Modern Tribe).

Display a list of your events by either adding a block in the new editor, or adding a shortcode to any post, page, or widget.

Heres a quick video showing you what you can do:

If you need extra design and functionality, Get The Events Calendar Shortcode Pro! The Pro version offers seven designs, additional filtering options, and full control over how your events display.

You get the same full integration with The Events Calendar, plus premium support, show multiple shortcodes on one page, and it works with any WordPress theme.

Check out the Pro version today

Trusted by 20,000+ WordPress sites and a 4.5 star rating on, The Events Calendar Shortcode and Block is the solution youve been after

How to use The Events Calendar Shortcode

You can use the shortcode or block to add a list of your events, filtered by various options. Heres an example of how youd show the next 8 events in the category festival:

[ecs-list-events cat="festival" limit="8"] 

You can also filter the shortcode to choose from the following options:

  • Category: show events from specific categories.
  • Number of events: choose the number of events to show.
  • Event order: Order in which your events are shown (latest first or last).
  • Event dates: Show or hide the date.
  • Event venue: Show or hide the venue.
  • Event excerpt: Show or hide the event excerpt, and set an excerpt length.
  • Thumbnail: Show or hide a thumbnail image.
  • View all events link: Choose whether to include a view all events link or not.
  • Events from a specific month: show only events from specific months (including current or next month).
  • Previous events: Show previous events.
  • Hide started events: Hide events when their start time passes.

This gives you full control over how your events are displayed, and is perfect for non-profits, charities, businesses, conferences, and anyone with a WordPress website showing events.

Youll find a full list of how to use these options in the shortcode below in the plugins FAQs.

With Pro, choose your design and get even more control

The Events Calendar Shortcode Pro adds extra designs, including a true calendar view, compact and column-based designs, and advanced features like events grouped by day.

Plus, get advanced control over how your events display:

  • Events in the next week: Show events happening in the next X days, for example tomorrow, next week, or next month.
  • Only specific days: Show only events on specific days.
  • Display events by location: Choose to show events by city, state, or country!
  • Only featured events: Show only events you mark as featured.
  • Full event description: Show the full event description, instead of just a short excerpt.
  • Only show start time: Just show the start time of your event.
  • Hide recurring events: Only show the first instance of a recurring event.
  • Filter bar: Allow visitors to choose what events they want to see.
  • Pagination: Let visitors show additional pages of events.
  • Custom design: Create your own templates, or use one of the seven built-in options.
  • Plus much more: check out The Events Calendar Shortcode Pro details here.

The Events Calendar Shortcode Pro is ideal for non-profits, charities, businesses, conferences, developers, and WordPress agencies who need the extra control and support straight from the plugin developer. Check it out here.

This plugin is not developed by or affiliated with The Events Calendar WordPress plugin or Modern Tribe in any way.



  1. Install The Events Calendar Shortcode Plugin from the repository or by uploading the-events-calendar-shortcode folder to the /wp-content/plugins directory. You must also install The Event Calendar Plugin by Modern Tribe and add your events to the calendar.

  2. Activate the plugin through the Plugins menu in WordPress

  3. If you dont already have The Events Calendar (the calendar you add your events to) you will be prompted to install it

You can then add The Events Calendar Block or [ecs-list-events] shortcode to the page or post you want to list events on. Full list of options available in the documentation.


Heres the full list of shortcode and block options you can use to customize how your events display:

  • Basic shortcode: [ecs-list-events]
  • cat Show events from an event category [ecs-list-events cat='festival'] or specify multiple categories [ecs-list-events cat='festival, workshops']
  • limit Total number of events to show. Default is 5. [ecs-list-events limit='3']
  • order Order of the events to be shown. Value can be ASC or DESC. Default is ASC. Order is based on event date. [ecs-list-events order='DESC']
  • date To show or hide date. Value can be true or false. Default is true. [ecs-list-events eventdetails='false']
  • venue To show or hide the venue. Value can be true or false. Default is false. [ecs-list-events venue='true']
  • excerpt To show or hide the excerpt and set excerpt length. Default is false. [ecs-list-events excerpt='true'] //displays excerpt with length 100
    excerpt=300? //displays excerpt with length 300
  • thumb To show or hide thumbnail image. Default is false. [ecs-list-events thumb='true'] //displays post thumbnail in default thumbnail dimension from media settings.
  • thumbsize Specify the size of the thumbnail. [ecs-list-events thumb='true' thumbsize='large']
  • thumbwidth / thumbheight Customize the thumbnail size in pixels [ecs-list-events thumb='true' thumbwidth='150' thumbheight='150']
  • message Message to show when there are no events. Defaults to There are no upcoming events at this time.
  • viewall Determines whether to show View all events or not. Values can be true or false. Default to true [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false']
  • contentorder Manage the order of content with commas. Default to title, thumbnail, excerpt, date, venue. [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false' contentorder='title, thumbnail, excerpt, date, venue']
  • month Show only specific month (in YYYY-MM format). Type 'current' for displaying current month only or 'next' for next month. [ecs-list-events cat='festival' month='2021-06']
  • past Show Outdated Events. [ecs-list-events cat='festival' past='yes']
  • key Hide events when the start date has passed [ecs-list-events cat='festival' key='start date']
  • orderby Change the ordering to the end date [ecs-list-events orderby="enddate"]

With The Events Calendar Shortcode PRO you also get the following options:

  • design Shows improved design by default. Set to standard for the regular one, compact for a more compact listing, calendar for a monthly calendar view, columns to show a horizontal/columns/photo view, or grouped to group events by day
  • days Specify how many days in the future, for example [ecs-list-events days="1"] for one day or [ecs-list-events days="7"] for one week
  • tag Filter by one or more tags. Use commas when you want to filter by multiple tags.
  • id Show a single event, useful for displaying details of the event on a blog post or page
  • location (city, state/province, country) Display events by location. Use commas when you want to include events from multiple (ie. country=United States, Canada)
  • description Use the full description instead of the excerpt of an event in the listing
  • raw_description Avoid filtering any HTML (spacing, links, bullet points, etc) in the description
  • raw_excerpt Avoid filtering any HTML (spacing, links, etc) in the excerpt
  • featured only Show only events marked as featured
  • date Show only events for a specific
    day [ecs-list-events date='2022-04-16']
  • year Show only events for a specific year [ecs-list-events year='2021']
  • date range Show only events between certain days [ecs-list-events fromdate='2021-05-31' todate='2021-06-15']
  • timeonly To show just the start time of the event. [ecs-list-events timeonly='true']
  • offset Skip a certain number of events from the beginning, useful for using multiple shortcodes on the same page (with ads in between) or splitting into columns
  • custom design Create one or more of your own templates for use with the shortcode
  • filter bar Allow the user to filter the events shown in the full calendar design (ie. by category, state/province, country, venue, etc)
  • hiderecurring To only show the first instance of a recurring event, set to true

Get The Events Calendar Shortcode & Block PRO

Yes! There is now a block to list your events anywhere in a page or post, just click + in the top-left and search for The Events Calendar Block (under Common).

You can put the shortcode in a text widget (as of WordPress 4.7). If a regular text widget doesnt work, put the shortcode in a Visual Editor Widget.

By default the plugin does not include styling. Events are listed in ul li tags with appropriate classes for styling with a bit of CSS.

  • ul class=ecs-event-list
  • li class=ecs-event and ecs-featured-event (if featured)
  • event title link is H4 class=entry-title summary
  • date class is time
  • venue class is venue
  • span .ecs-all-events
  • p .ecs-excerpt

Want a better looking design without knowing any CSS? Check out The Events Calendar Shortcode & Block PRO

Put this in the template where you want the events list to display.

The pro version of the plugin has the option to put design="calendar" in the shortcode (or pick Calendar as the design with the block) to show a calendar view of the events you want.

Leave a Reply

Your email address will not be published.

Fill out this field
Fill out this field
Please enter a valid email address.
You need to agree with the terms to proceed

Most Viewed Posts