Default Design

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.

Late Night Party

$5
August 2 @ 8:00 pm - August 3 @ 1:00 am
Party Haus
330 S Broadway Unit 602
Los Angeles, CA 90013 United States
+ Google Map

Postponed Farmer’s Market

August 23 - August 24
Bamboo Fresh
655 Front St. #108
Lahaina, 96761 United States

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

Farmer’s Market

December 23 - December 24
Bamboo Fresh
655 Front St. #108
Lahaina, 96761 United States

Kitten Adoption Day

January 1, 2025
Winchester Mystery House
525 S Winchester Blvd
San Jose, 95128 United States

Excerpt

You can show the excerpt with:

[ecs-list-events excerpt="true"]

Movie Marathon

August 14 - September 14
Winchester Mystery House
525 S Winchester Blvd
San Jose, 95128 United States

Dictumst nunc in turpis ad, ullamcorper enim quis donec sodales, placerat lorem volutpat penatibus, ...

Rock Concert

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

Suspendisse magna aliquet integer molestie, nunc justo dolor nec tellus, lobortis sit nisl dignissim...

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

Kitten Adoption Day

January 1
Winchester Mystery House
525 S Winchester Blvd
San Jose, 95128 United States

Ut donec ut facilisis molestie, orci in mi molestie, adipiscing vestibulum et ante, neque quis mollis nunc dictumst. Elit placerat sit elit wisi, voluptas wisi amet ultricies non, in maecenas imperdiet ornare. Nisl urna quisque aptent sollicitudin, venenatis donec nulla eu cursus. Cras posuere wisi luctus ut, magna porttitor suspendisse lectus, mi id nulla quis, nec viverra justo gravida quam. Vulputate nec augue varius, quibusdam enim conubia nibh, fusce vestibulum faucibus fringilla, proin lectus varius dolor. Ante sed sem id, est justo dolor turpis, eleifend sit nonummy erat per, faucibus erat natoque in. At id arcu nullam lorem, fusce faucibus mi a, lorem id dolor velit. Consequat ac in curabitur id, mauris nulla facilisi consectetuer sem. Est sed duis suspendisse, class sit adipiscing commodo, leo eu ac ut dignissim. Erat id mauris etiam sagittis, tortor at curabitur adipiscing vestibulum. Sed ante rutrum ipsum nec, neque sed elementum et nonummy, integer nunc vivamus rutrum, justo dapibus wisi quis eget. Turpis per nunc fusce tristique, urna malesuada cum et vitae.

Cost

The cost can also be displayed in this view:

[ecs-list-events limit="2" cost="yes"]

Rock Concert

$15 – $40
May 1 @ 8:00 pm - 11:30 pm
Doug Fir Lounge
830 E. Burnside St.
Portland, 97214 United States

Late Night Party

$5
May 2 @ 8:00 pm - May 3 @ 1:00 am
Party Haus
330 S Broadway Unit 602
Los Angeles, CA 90013 United States
+ 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"]

Late Night Party

August 2 @ 8:00 pm - August 3 @ 1:00 am
Party Haus
330 S Broadway Unit 602
Los Angeles, CA 90013 United States
+ Google Map

Postponed Farmer’s Market

August 23 - August 24
Bamboo Fresh
655 Front St. #108
Lahaina, 96761 United States

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

Farmer’s Market

December 23 - December 24
Bamboo Fresh
655 Front St. #108
Lahaina, 96761 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"]

January 2024

Kitten Adoption Day

January 1
Winchester Mystery House
525 S Winchester Blvd
San Jose, 95128 United States

Board Meeting

January 15 @ 12:00 pm - 1:30 pm

Rock Concert

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

February 2024

Rock Concert

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

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

Farmer’s Market

December 23 - December 24
Bamboo Fresh
655 Front St. #108
Lahaina, 96761 United States

Kitten Adoption Day

January 1, 2025
Winchester Mystery House
525 S Winchester Blvd
San Jose, 95128 United States

Board Meeting

January 15, 2025 @ 12:00 pm - 1:30 pm

Rock Concert

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

Rock Concert

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