EventKoi Calendar (List View) shortcode: All supported attributes

Overview

This guide documents how you can set attributes for EventKoi’s calendar in list view using its shortcode.

This is the base shortcode:

[eventkoi_calendar display="list"]

Supported attributes (list view)

Attribute	Type	Default	Accepted values	What it does
id	string	Default calendar	Calendar ID ("2"), comma-separated IDs ("2,5,8"), or "all"	Chooses which calendar(s) to query.
display	string	"calendar"	For this doc: "list"	Switches to list mode.
orderby	string	"date_modified"	upcoming, date_modified, publish_date, title, event_start	Sort field. publish_date maps to publish date, and event_start sorts by the event start datetime.
order	string	"desc"	asc, desc	Sort direction. If orderby="upcoming" and order is omitted, it auto-defaults to asc.
per_page	int	10	1 to 100	Batch size per list request / load chunk.
max_results	int	0	0 to 1000	Hard cap on total returned items. 0 means no cap.
date_start	date string	empty	YYYY-MM-DD	Only include items starting on/after this date.
date_end	date string	empty	YYYY-MM-DD	Only include items starting on/before this date.
expand	bool	empty	1/0, true/false, yes/no, on/off, or bare expand	Source-of-truth flag for recurring expansion in list view. Bare expand (no value) is treated as true.

Examples

1) Basic list

[eventkoi_calendar id="2" display="list"]

2) All calendars, nearest upcoming first

[eventkoi_calendar id="all" display="list" orderby="upcoming" order="asc"]

3) Date-windowed list

[eventkoi_calendar id="all" display="list" orderby="upcoming" order="asc" date_start="2026-06-01" date_end="2026-06-30"]

4) Expand recurring instances

[eventkoi_calendar id="2" display="list" orderby="upcoming" order="asc" expand=1]

5) Limit loaded results

[eventkoi_calendar id="all" display="list" per_page="20" max_results="200"]

Behavior notes

• id is optional. If omitted, EventKoi uses the default calendar.
• id="all" fetches events across all calendars.
• Invalid orderby falls back to date_modified.
• Invalid order falls back to desc.
• per_page and max_results are clamped for safety (100 and 1000 max).
• date_start and date_end should always be YYYY-MM-DD.
• For recurring events, use expand when you want each occurrence listed separately.

Shortcode maker

You can create an event calendar list shortcode by heading to Events > Calendars. Then selecting the calendar you want to edit.

In this example, we will create a shortcode for the Default calendar.

In the Calendar settings Main tab, select the following settings:

1. Default calendar display: Select list
2. Sort events by
3. Sort direction
4. Events per page
5. Max results
6. Start date
7. End date
8. Expand recurring instances

Then go to the Embed tab. There you’ll see the shortcode based on the settings you created in the Main tab. You can copy it and paste the shortcode any where you like.

Troubleshooting

• No events found: verify calendar ID(s), status/publish state, and date range.
• Unexpected sort: set both orderby and order explicitly.
• Recurring not expanded: add expand=1.