Events
Overview
The Events post type is where all event content lives. Each event is a public post with a locked Single Event block template, featured image support, and native post meta for scheduling, venue, and structured data.
For step-by-step setup — creating events, adding listing blocks to a page, recurring series, and ticketing — start under Usage. This page is the field reference for the Document sidebar panels.
What visitors see
Each event gets its own URL (permalink slug defaults to /events/{post-name}/ — configurable in Events Global Settings). Listing blocks like Events link to these pages. A typical single event shows:
- Event title and formatted start (and optional end) time
- Venue and address (when enabled in Customizer)
- Optional excerpt, map embed, buy button or ticket link, and phone/email/website
- Freeform body content you build with blocks inside Single Event
See Hang Ten — Tarlton Theatre for a filled-out single event in production.
WordPress features
- Supports: title, editor, thumbnail, excerpt, custom-fields
- Archive: disabled — use Events or Events Calendar blocks on a page instead of a native archive
- Permalink slug: Customizer Slug (default
events) - Default template:
ds/single-eventwith a starter paragraph; new blocks can be inserted but the root template cannot be removed (template_lock: insert) - Taxonomies: Event Categories (hierarchical), Event Tags (flat)
Event Information (sidebar)
Core scheduling and venue fields:
- Starts — required date/time; drives all listing, calendar, and countdown behavior
- Ends — optional; multi-day events and "ongoing" detection use this field
- Location — Dirigible Locations post when that plugin is active (Custom keeps manual venue fields). When a location is linked, manual address fields hide.
- Website URL / Website Title — venue or external ticketing site
- Venue, Street Address, City, State, Zip, Phone, Email Address — manual venue details when Location is Custom
- Video URL — YouTube or Vimeo; the Events block can prefer video thumbnails over featured images
- Map Embed — paste a map embed iframe for the single-event layout
Recurring controls appear on the series parent only — see Usage → Recurring events.
Using the excerpt
The WordPress Excerpt field is surfaced by Events listing blocks — ideal for short show details that appear on index pages without opening the full event:
- Door time and showtime (
7:30pm // Appleton Beer Factory) - Lineup or bill order (
Hotline TNT, Disq, Cry Baby, Hang Ten) - Ticket or age restrictions
Event Meta (sidebar)
Schema.org fields for JSON-LD and rich results (mirrored on the Single Event block inspector under Event Meta):
- Status — Scheduled (default), Cancelled, Postponed, Rescheduled, Moved Online
- Attendance Mode — Offline (default), Online, Mixed
- Organizer Name / Organizer URL — defaults to site name and URL when blank
- Performers — name and type (Music Group, Person, Group, Organization)
- Ticket Price, Ticket URL, Ticket Availability — for external ticket links and schema offers when WooCommerce ticketing is off or Sell tickets for this event is disabled
WooCommerce ticketing is covered in Usage → Ticketing.
Tips
- Always set Starts — without it, events won't appear in listings or the calendar.
- Use Ends for festivals and multi-day conferences so they stay in "ongoing" filters correctly.
- Link a Location post when Dirigible Locations is active instead of retyping addresses.
- Configure date display formats under Events Global Settings.
- For external ticket vendors (Ticketmaster, Eventbrite, etc.), leave WooCommerce ticketing off and use Ticket URL in Event Meta instead.
Screenshots
Editor
-
Event Information sidebar — Starts, venue, address, and contact fields.
Settings
Event Information
Required start date and time. Drives upcoming/past filtering, calendar placement, countdown blocks, and JSON-LD structured data.
Optional end date and time. Use for multi-day festivals, ongoing exhibitions, or events that span more than one day.
Turn on to generate a series of dated occurrence posts from this parent event. Only available on the series parent, not on individual occurrences.
How often new occurrences are generated: Daily, Weekly, Bi-Weekly, Monthly, or Yearly.
- DailyCreates an occurrence every day until Repeat Ends.
- WeeklyCreates an occurrence every week on the same weekday as Starts.
- Bi-WeeklyCreates an occurrence every two weeks.
- MonthlyCreates an occurrence on the same day of each month.
- YearlyCreates an occurrence on the same date each year.
Last date and time the series should generate new occurrences.
Link a Dirigible Locations post for this event. When set, manual venue and address fields are hidden and location data is pulled from the linked post. Choose Custom to enter venue details manually.
- CustomEnter venue and address fields on this event instead of linking a Location post.
External URL for the event or venue. Displays on single event pages when Show Website is enabled.
Link text for the event or venue website. Displays with Website URL when Show Website is enabled.
Venue or room name (e.g. "Tarlton Theatre"). Shown on singles and listing blocks; hidden when a Location post is linked.
Street address for the venue. Only used when no Dirigible Location post is linked.
City for the event venue. Shown on single event pages and in listing blocks when address parts are enabled.
State or province for the event venue. Commonly shown with city on listing blocks and single event headers.
Postal or ZIP code for the venue address. Optional; enable on listing blocks via Show Zip when needed.
Contact phone number for the event or venue. Displays on single event pages when Show Phone is enabled.
Paste a map embed iframe (Google Maps or similar). Renders on the single event page when a Location post is not linked.
Contact email for the event. Displays on single event pages when Show Email is enabled in Events Single Template settings.
YouTube or Vimeo URL for the event. Can be used as the preferred image source in Events blocks when no featured image is set.
Ticketing
Sell tickets through WooCommerce for this event. Requires Enable Ticketing in Events Global Settings and an active WooCommerce install.
Ticket price in USD. In the Ticketing panel this drives the WooCommerce buy button; in Event Meta it feeds schema.org offers for external ticket links when WooCommerce ticketing is off.
Custom label for the buy button on the single event page. Leave empty to use the default price-aware label.
Maximum tickets for this event, or shared venue pool when ticket types are enabled. Leave empty for unlimited.
Show remaining ticket count under the buy button on the single event page.
Event Meta
Current status: Scheduled, Cancelled, Postponed, Rescheduled, or Moved Online. Cancelled and postponed states are reflected in structured data.
Whether the event is Offline (in person), Online (virtual), or Mixed. Feeds schema.org attendance mode for search engines.
- OfflineIn-person event.
- OnlineVirtual / online only.
- MixedBoth in-person and online.
Name of the event organizer for schema.org metadata. Leave blank to use your site name.
Website URL for the event organizer. Leave blank to use your site URL.
Ticket price in USD. In the Ticketing panel this drives the WooCommerce buy button; in Event Meta it feeds schema.org offers for external ticket links when WooCommerce ticketing is off.
External URL where visitors can buy tickets. Use when ticketing runs outside WooCommerce; renders as a link on single event pages and in offers schema.
Ticket stock status for schema.org offers when WooCommerce ticketing is off or Sell tickets is disabled: In Stock, Sold Out, Pre-Order, or Pre-Sale.