Single Event
Usage
Single Event is the block every event page is built in. New events open with it already in place and it can't be removed, so the event header and details always look consistent. Everything inside it is yours to edit.
If the editor shows "Block contains unexpected or invalid content" on Single Event (this can happen on imported events), select Attempt recovery. It rebuilds the block and keeps the blocks inside it, dropping only the stray text the warning is about. Don't use Resolve here: its conversion would turn the event into loose blocks without Single Event, so its buttons do nothing on events. Once it's repaired the event works as normal.
Visitors reach this page from Events listing blocks. The block shows the title, dates, venue details, an optional map and ticket links, then whatever blocks you add inside.
Layouts
Choose Layout in the block sidebar, or select the layout's name on the gray bar at the top of the event in the editor: the layouts open as tiles with a small drawing of each page, and the event changes behind them as you pick. site default after the name means the event follows Default Single Template from Events → Settings, which new events start with.
- Sidebar (Customizer default) — event details in a column beside your content
- Default / Simple — single-column header and body
- Billboard — large hero header
- Article — magazine-style layout with optional Header Align (Wide or Default)
- Details Right — Sidebar mirrored: your content on the left, the photo and details in a column on the right
- Photo Banner — the photo across the page, dimmed, with the title and date over it; the other details in a row below. Without a photo, the title sits on the background
- Centered — the photo, title and every detail centered in one column, then your content. The photo is cropped to 16:9 so the title stays near the top; choose None under Photo → Aspect Ratio to show it whole
- Details Bar — the title, then the date, venue, cost and contact in a row of columns (stacked on phones), then your content. No photo; columns with nothing in them are left out
- Poster — the photo whole, at its own shape (a gig flyer), beside the details
- Series — for a recurring event: the repeat rule in words ("Every week on Saturday") and the upcoming dates, each linked to its own page. Dates that pass drop off the list on their own. An event that doesn't repeat shows just its date
- Freeform — only what you build inside the block. The event's date, venue and other details still reach event lists, the calendar and search engines
- Lineup — a gig poster: the date and title, then the performers (from Lineup in the event's sidebar) with the first one large as the headliner, then the venue and tickets, all centered
- Box Office — the title, photo and details beside a tickets card with the cost, the buy button (tickets sold on this site) or a Get tickets button to the event's Ticket URL, and the calendar link
- Video Hero — the video across the top (the photo when there's no video), then the details
- Map Split — the map on one half of the page and the details on the other
Every layout shows a notice at the top when the event's Status is Cancelled, Postponed, Rescheduled or Moved Online. While it's Scheduled, Status: Scheduled sits on the bar at the top of the event in the editor, beside the layout; select it to set the Status.
Every layout also shows breadcrumbs at the top (Home › Events › the event) once the site has an Events Page (Events → Settings), which is filled in for you. They replace the "← All Events" link older versions showed among the details. If you add a DS Breadcrumbs block of your own inside an event, only yours shows.
Under Style in the block sidebar (not shown for Freeform, which has only your content):
- Title Style — text style for the event title (default h3). Also Edit on the title in the editor
- Background — the color behind the event header (default Gray)
- Text Color — Dark or Light text on the background. Choosing a background picks the one that reads better; you can change it after. Background and Text Color are also on the round brush button at the top right of the event in the editor
Settings for one part of the event live with that part: select Edit on it in the editor, or on its row under Event Details in the sidebar.
Not on the page
The editor shows the event as its page shows it. A part the page leaves out isn't drawn there: it's a button under Not on the page on the bar at the top instead. That's a part the layout doesn't show (Article has no photo, venue or contact details), or a detail a setting in Events → Settings turns off for every event (Show Categories, Show Address, Show Website, Show Email, Show Phone). Select it to see why, open Events Settings, or edit its fields.
The short description is the one part you turn off per event: hover it and select Short Description to switch Show Excerpt, or select it under Not on the page to put it back. It moves when the menu closes, with Undo in the notice at the bottom. Show Excerpt is also in its Edit window.
- Photo → Aspect Ratio — the shape the photo is cropped to, in layouts that crop it
- Date & Time → Show Time — show start and end times (default on)
- Short Description → Show Excerpt — show the short description on the event page
Your content
Add paragraphs, photos, columns, embeds, or any Dirigible block inside Single Event. New events start with a placeholder paragraph.
The header fills itself in from the event's fields (Starts, venue, tickets, map embed), so you don't need to repeat dates or addresses in the body. In the editor, each part of the header has an Edit button that opens its fields; see Post Types → Events.
What goes where
| Put it in | What it's for |
|---|---|
| Starts / Ends | Listings, the calendar, and search results |
| City, State, Venue | Addresses on listing blocks and maps |
| Excerpt | Short copy on Events cards (door time, lineup) |
| The block content | Photos, long descriptions, embeds, ticket calls to action |
Block width
Single Event defaults to Full width alignment.
Tips
- Set the default layout under Customizer → Events → Events Single Template, then change Layout on any event that needs something different.
- Pair with Event Countdown on a landing page to promote one upcoming date.
Settings
Layout
Appears when Layout is Article. Wide stretches the header across the content area.
Style
Text style for the event title (default H3).