Requirements: EventKoi Pro, and Divi 4 (either the Divi theme or the Divi Builder plugin – not both).
The EventKoi Loop module lets you display a queryable list of events on any Divi page. You control which calendar to pull from, how events are ordered, how many to show per page, and whether to use pagination or infinite scroll.
How to add the EventKoi Loop module
- Open the page you want to edit and launch the Divi Builder.
- In your layout, click the grey Insert Module button.
- In the module picker, search for EventKoi or scroll to find it.
- Click EventKoi Loop to insert it.
Configuring the EventKoi Loop module
Click the module to open its settings. The EventKoi settings are on the Content tab, split across two toggles: Loop and Query.
Loop settings
Calendars – choose which calendars to pull events from. Options are:
- Default calendar – uses your site’s default calendar. Available on Lite and Pro.
- All calendars – pulls events from every calendar on your site. Requires EventKoi Pro.
- Specific calendar – lets you choose one calendar from a dropdown. Requires EventKoi Pro.
Query settings
Order by – sets how events are sorted. Options are:
- Upcoming events (default) – shows future events, soonest first
- Past events – shows past events, most recent first. Order is always descending when this is selected.
- Event start date – sorts by the event’s start date
- Publish date – sorts by when the event was published
- Modified date – sorts by when the event was last edited
- Title – sorts alphabetically by event title
Order – set to Ascending or Descending. Note that selecting Past events above always forces descending order.
Items per page – how many events to show per page. Default is 10, maximum is 100.
Expand recurring instances – when set to Yes, each occurrence of a recurring event appears as a separate item in the list. When set to No (the default), only the parent event is listed.
Load mode – controls how additional events are loaded:
- Pagination (default) – shows page numbers at the bottom of the list
- Infinite scroll – automatically loads more events as the visitor scrolls down
Max results – the total number of events to return across all pages. Set to 0 for no limit (up to 1000). Default is 0.
Date from and Date to – optionally restrict the list to events within a date range. Enter dates in YYYY-MM-DD format (for example, 2025-06-01).
The Design and Advanced tabs give you Divi’s standard spacing, border, and custom CSS options if you need them.
When you’re done, save your page.
Previewing your event list
The EventKoi Loop module renders server-side and won’t show a live preview in the Divi Builder. View the page on the frontend to see the event list as your visitors will.
Get more from your EventKoi + Divi integration
There are multiple ways to integrate EventKoi with Divi – from displaying individual event data to building fully custom event templates. To see all the available approaches, read our EventKoi + Divi integration overview.