Events list section
The Events list section of Local lists the events of your events blog by date, soonest first, with an option to hide past events.
Applies to: Local 4.2.1 and later. Added in: Local 4.2.0. Last checked: 2026-10-13 against Local 4.2.1.
The Events list section lists the events of your events blog as cards, by start date, soonest first. Use it on an events page, on the home page for upcoming events, or under each event for other events.
Where to find it: in the theme editor, select Add section on any template and choose Events list.
The events, their dates and the metafields are set up on Events calendar. The steps to build an events page with this section are there too, under "Building the events page". For other events under each event, see "Showing event recommendations" on Event page.
Local 4.2.1 does not include the event blog post template in its theme files, and the theme editor cannot create it: its section cannot be added with Add section. Without it, event cards open the post in the default blog post layout. If the template picker has no Blog posts → event template, contact Krown support.
Heading
The section has the standard heading settings: Heading (default "Upcoming events"), Subheading, Text alignment, and Show section link with Link text and Link, for example to your events page. See General section styling.
Content
- Events blog chooses the blog that holds your events. Without a blog, the section shows sample cards.
- Number of events to show sets 1 to 50 events (default 4).
- Hide past events leaves out events whose date has passed. An event stays listed for its whole day.
How the list is sorted:
- By start date and time, earliest first. With Hide past events off, past events come first, then the upcoming ones.
- Posts without a date are left out, as long as a date metafield is set in Theme settings → Events.
- If no post of the blog has a date, the list shows the posts in blog order.
- On an event page, the event being viewed is always left out.
The section reads up to 250 posts of the blog.
Event card
Each card shows the year, the day and month, the weekday and the time range of the event, then its title.
- Show featured image shows the post's featured image.
- Show tags shows the post's tags.
- Show excerpt shows the post's excerpt in full, or the start of its content when it has no excerpt. Number of words sets that length (default 25).
- Show link to event adds a "View event" button. Button style sets it to Outline or Solid.
The title and the button open the event page. Custom card design sets the card colors, and Section design, SEO and Visibility are the standard section settings. The first Section design setting is labeled Section design in the editor; it is the section's background color.
Why is an event missing from the list?
Usually because the post has no date, the event is past, or the list is full.
- Fill the date metafield on the post. Posts without a date are left out.
- Check Hide past events: an event disappears the day after its date.
- Raise Number of events to show.
- Check that the post is in the blog selected in Events blog, and that it is published (visible).
Why do past events still show?
Because Hide past events is off, which is the default. Past events then come first, before the upcoming ones. Turn on Hide past events in the Events list section; an event stays listed until the end of its day.
Is the Events calendar preset of Content toggles the same thing?
No. The Content toggles section has a preset called Events calendar, a hand-written list of toggles with sample event rows. It does not read your events blog or its metafields. Use the Events list section for events from your blog.
All Events list settings
Every setting, with its type and default.
Events list section: Heading
Where to find it: Events list → Heading
The Events list section uses the standard Heading settings, listed in General section styling.
Heading (text field, default: "Upcoming events").
Subheading (text field).
Text alignment (dropdown, default: Left). Options: Left, Center.
Show section link (checkbox, default: off).
Link text (text field). Shown only when Show section link is on.
Link (link). Shown only when Show section link is on and Link text is set.
Open link in a new window (checkbox, default: off). Shown only when Link is set and Show section link is on and Link text is set.
These settings differ from the standard ones or exist only here:
Heading (text field, default: "Upcoming events").
Subheading (text field).
Events list section: Content
Where to find it: Events list → Content
Events blog (blog picker): The blog that holds your events. Without a blog, the section shows sample cards.
Number of events to show (slider 1 to 50, default: 4): The most events the list shows, after sorting by start date.
Hide past events (checkbox, default: off): Leaves out events whose date has passed. An event stays listed for its whole day. When off, past events come first.
Events list section: Event card
Where to find it: Events list → Event card
Events need to be configured as custom blog posts. See Events calendar.
Show featured image (checkbox, default: on).
Show tags (checkbox, default: on).
Show excerpt (checkbox, default: on): Shows the post's excerpt in full, or the start of its content when it has no excerpt.
Number of words (slider 5 to 40, default: 25): The number of words shown from the post content when the post has no excerpt. Shown only when Show excerpt is on.
Show link to event (checkbox, default: on): Adds a View event button that opens the event page.
Button style (dropdown, default: Outline). Options: Outline, Solid. Shown only when Show link to event is on.
Events list section: Custom card design
Where to find it: Events list → Custom card design
The Events list section uses the standard Custom card design settings, listed in General section styling.
Background (color, default: transparent).
Text (color, default: transparent).
Accent (color, default: transparent).
Border (color, default: transparent).
Shadow (color, default: transparent).
Hide border (checkbox, default: off).
Hide shadow (checkbox, default: off).
These settings differ from the standard ones or exist only here:
Accent (color, default: transparent).
Events list section: Section design
Where to find it: Events list → Section design
The Events list section uses the standard Section design settings, listed in General section styling.
Section design (color, default: transparent): Sets the section's background color (the editor labels this setting Section design).
Background gradient (gradient).
Text color (color, default: transparent).
Descrease top margin (checkbox, default: off). Shown only when Remove top margin is off.
Remove top margin (checkbox, default: off). Shown only when Descrease top margin is off.
These settings differ from the standard ones or exist only here:
Section design (color, default: transparent): Sets the section's background color (the editor labels this setting Section design).
Text color (color, default: transparent).
Events list section: SEO
Where to find it: Events list → SEO
The Events list section uses the standard SEO settings, listed in General section styling.
Heading tag (dropdown, default: H2): Specify heading level to help search engines index the structure of your page. Options: H1, H2, H3, H4, span.
Events list section: Visibility
Where to find it: Events list → Visibility
The Events list section uses the standard Visibility settings, listed in General section styling.
Section visibility (dropdown, default: Show always). Options: Show always, Show only on mobile, Show only on desktop.
Related pages
- Events calendar: the events setup, metafields and the events page.
- Event page: the page each event card opens.
- Blog posts section: the latest posts of any blog.
- Content toggles section: collapsible content, including the Events calendar preset.