This is the default design in The Events Calendar Shortcode Pro if you don’t specify another one. This design is good for a list view within a post or a page.
[ecs-list-events]
You can change how many events are displayed with the limit parameter, ie.
[ecs-list-events limit="2" cost="yes"]
Note if the ‘Google Maps Link’ is enabled for an event, it will be shown. Also if the status of the event is Cancelled or Postponed it will be displayed.
Holiday Baking Blitz
Free
Kingston, ON M85 524 Canada + Google Map
Ramen from Scratch
$90
Ottawa, ON M88 455 Canada
Pagination
Show previous and next links, allowing more events to be displayed by visitors. The amount of events on each page can be controlled using the limit value.
[ecs-list-events pagination="true" limit="2"]
Street Food Tour: Flavors of Asia
Stowe, VT 50333 United States
Holiday Baking Blitz
Kingston, ON M85 524 Canada
Excerpt
You can show the excerpt with:
[ecs-list-events excerpt="true"]
Sushi Rolling for Beginners
New York, NY 14588 United States + Google Map
Learn professional tips you can use in your home kitchen. Tasting portions served throughout the ses...
Tapas & Paella Evening
New York, NY 14588 United States
A guided class with time for Q&A and tasting. Vegetarian and gluten‑free adjustments available...
Description
The full description content can be shown by adding description=”true” or even showing the full description content (with formatting/HTML) using:
[ecs-list-events excerpt="true" description="true" raw_description="true"]
Sushi Rolling for Beginners
New York, NY 14588 United States + Google Map
Learn professional tips you can use in your home kitchen. Tasting portions served throughout the session.
All materials supplied.
Cost
The cost can also be displayed in this view:
[ecs-list-events limit="2" cost="yes"]
Holiday Baking Blitz
Free
Kingston, ON M85 524 Canada + Google Map
Ramen from Scratch
$90
Ottawa, ON M88 455 Canada
Button
You can put whatever text you want with the button option, and modify the colors of the button with buttonbg and buttonfg
Note: Adding buttonlink=”website” will change the button to use the “Event Website URL” (ie. a link to an external ticketing site) instead of the internal link to the event.
[ecs-list-events limit="2" buttonbg="#f77530" buttonfg="white" button="View Details"]
Holiday Baking Blitz
Kingston, ON M85 524 Canada + Google Map
Ramen from Scratch
Ottawa, ON M88 455 Canada
Rounded Corners (Border Radius)
Change how rounded the corners are, or remove the rounded corners, on the thumbnail image and the details button.
[ecs-list-events border-radius="0" limit="1"]
Street Food Tour: Flavors of Asia
Stowe, VT 50333 United States
Group by Month/Day
Adds a heading with the month before each event. Use groupby=”day” to group by day instead.
[ecs-list-events limit="4" groupby="month"]
February 2026
Sushi Rolling for Beginners
Toronto, ON M92 712 Canada
Plant‑Based Comfort Foods
Toronto, ON M16 687 Canada
Taco Tuesday Fiesta
Chicago, IL 60603 United States
Ramen from Scratch
Toronto, ON M92 712 Canada
Filter Bar
Let your visitors select the events they want to see with the filter, on any page! See the Filter Bar page for more examples.
[ecs-list-events design="default" filterbar="true" pagination="true" filterorder="category, venue, state, country, tag, fromdate"]
Street Food Tour: Flavors of Asia
Stowe, VT 50333 United States
Holiday Baking Blitz
Kingston, ON M85 524 Canada