Events

Usage

The Events block shows an upcoming-events list or card grid anywhere on your site. Pick List, Cards, Mini, or Agenda, choose upcoming, past, ongoing, future, or all events, and optionally narrow it to certain Event Categories.

Use it for tour dates, class schedules, fundraisers, or conference agendas.

Real-world example

hangtenband.com/shows uses two Events blocks on one page:

1. Upcoming Shows — Display set to Default (Ongoing & Future). When nothing is scheduled, the block says "There are no upcoming events at this time."
2. Past Shows — Display set to Past, Display As set to Cards, Columns set to 4, Image hidden, Title Style at h4, Show Address on with City and State, and each event's Excerpt used for door times and lineups.

Each card links to a single event page with the full show detail.

Content

• Display — Default (Ongoing & Future) (default), Ongoing, Past, Future, or All. Past events sort newest-first; upcoming sorts soonest-first.
• Preferred Image — Featured Image (default) or the thumbnail from the event's Video URL
• Category — show only certain Event Categories; leave empty for all
• Limit Events — when on, show up to Events To Show (1–50, default 3). Leave off for a full tour history.

Appearance

• Display As — List (image + copy side by side), Cards (default, responsive grid), Mini (compact grid), or Agenda (a dated list with month separators, see below)
• Columns — 1–5 per row for Cards and Mini (default 3)
• Title Style — text style for event titles
• Image — Default, Show, or Hide
• Image Aspect Ratio — golden rectangle, 1:1, 16:9, and more
• Excerpt — Default, Normal, Small, or Hide
• Link / Link Text — link style and label (default See Event). Set Link to Hide when the whole card is clickable.
• Spacing — vertical gap between items (XS through XL)
• Show Address — when enabled, choose Show Street, Show City (default on), Show State (default on), Show Zip. Agenda has its own Address choice instead (see below).

Agenda

Agenda is the layout of a show calendar or a what's-on page: each event has a date badge (weekday and day) on the left, then the time ("October 23 @ 8:00 pm - 9:00 pm", with no times for an all-day event and both days for one that spans days), the title, the venue in bold with its address, the excerpt, a ticket line, and the image on the right. Events are grouped under month headings. It respects the same Title Style, Image, Image Aspect Ratio (images show whole by default here), Excerpt, Link, and Spacing choices as the other layouts. In place of Show Address it has an Address choice: Full (the default) prints the street, city, state and zip after the venue name, Choose Parts uses the Show Street / City / State / Zip toggles, and Hide leaves the address out.

The Agenda panel adds:

• Show Venue (under Appearance) — the linked location's name, or the event's Venue field
• Month Separators — the month headings
• Image Position — Right (default) or Left
• Excerpt Length — words to show (default 30; 0 shows the whole excerpt)
• Show Tickets / Ticket Link Text — the ticket line: the event's Ticket URL as a link, its Cost (or Free), and, for tickets sold on the site, the ticket price and a live "N tickets left" count when the event shows its stock
• Search Box, Category Filter, Date Filter — a bar above the list. Visitors search by keyword, pick a category (only the categories chosen under Content, when any are), or jump to a From date; Today brings them back. Each result is a plain page address, so a filtered list can be bookmarked or shared and loads fast.
• Previous / Next Pages — pages of Events To Show each (needs Limit Events)
• Calendar Page Link — the address of a page with the Events Calendar block adds a List | Calendar switch. Give that calendar block a List Page Link back to this page so the switch works both ways.

Every event stays on the page until it ends, and ticket counts refresh when the page opens, so the list is right even on a site that caches pages.

Front-end behavior

Each event's Starts and Ends dates decide which Display mode it falls under.

When nothing matches, upcoming blocks say "There are no upcoming events at this time" and past blocks say "There have been no past events."

Block width

Events supports Wide (default), Full, Center, and None alignment.

Tips

• For a tour page, stack an upcoming block above a past-shows card grid.
• Hide Image on dense grids and let the title, date, and city do the work.
• For a what's-on page with search and filters, use Agenda with Limit Events and Previous / Next Pages; add a Calendar Page Link to let visitors switch to the month grid.
• For a month grid, use Events Calendar. To promote one date, use Event Countdown.