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 + Google Map
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"]
Croissants & Laminated Doughs
Chicago, IL 60603 United States
Learn to Make Macaroons
Hamilton, ON M59 744 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 + Google Map
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 + Google Map
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 + Google Map
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"]
Croissants & Laminated Doughs
Chicago, IL 60603 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"]
May 2026
February 2026
Plant‑Based Comfort Foods
Toronto, ON M16 687 Canada + Google Map
May 2026
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"]
Croissants & Laminated Doughs
Chicago, IL 60603 United States
Learn to Make Macaroons
Hamilton, ON M59 744 Canada
Curries Around the World
Hamilton, ON M59 744 Canada