Overview

Updated

Create an event

  1. In the WordPress admin, go to Events → Add New.
  2. Add a title (venue + bill names work well for concerts). Click the title on the event page and type: it's the event's title, the same one shown at the top of the editor.
  3. The editor shows the event page as visitors will see it. Select Edit on the date (hover it to see the button) and set Starts (required). Add Ends when the event spans multiple days or hours matter for filtering. The sidebar's Event panel has the same Edit buttons. (With a Dirigible theme older than 5.31.216, these fields are in the sidebar's Event Information panel.)
  4. Select Edit on the venue to fill City and State, or link a Location when Dirigible Locations is active. A linked location shows on the event page once it's published.
  5. Put door time, lineup, or ticket notes in the Excerpt. Listing blocks show it on each card.
  6. Build the single-event page inside the Single Event block (photos, embeds, supporting copy).
  7. Assign Event Categories if you filter listings by category.
  8. Publish.

For every field, see Post Types → Events. For recurring series or WooCommerce tickets, see the other Usage guides below.

Add events to a page

Events are listed wherever you place a block. To show an event calendar or upcoming-events list, add a block to any page:

  1. Edit the page in the block editor.
  2. Insert Events for a card or list of upcoming events, Events Calendar for a calendar layout, or Event Countdown for a single countdown.
  3. Configure the block sidebar (how many to show, category filters, layout).
  4. Publish the page.

Each event links to its own URL (default /events/{post-name}/, configurable under Events → Settings).

Your Events page

One page is your Events Page (Events → Settings): the page every event leads back to. Each event shows breadcrumbs above it (Home › Events › the event), so visitors can step back to the list.

You don't have to set it. The first time someone who can publish pages opens the admin after your first event is published, it's filled in for you, once:

  • a published page at your events address (/events/) becomes the Events page;
  • otherwise your one page with an Events or Events Calendar block does (the home page doesn't count; with several such pages, pick one yourself);
  • otherwise a new Events page is made at /events/ with an Events block on it. Edit it like any page. It isn't added to your menus.

Choose a different page under Events Page at any time. If you clear the setting or delete the page, it stays that way, and events show no breadcrumbs.

Events in site search

When a visitor searches your site, matching events show in their own section above the other results: a short dated list with each event's date, time, venue and city, soonest first, five at most. The heading counts them ("8 events"), and they count toward the search's total. Only upcoming events and ones happening now are listed: past events don't show in site search.

A search matches an event's title and description, and also its venue (the linked location's name, or the Venue field), street, city, state and ZIP, organizer, performers, and category and tag names: a search for a venue, a town or a band finds their events. Phone, email, ticket and price fields are never searched.

Explore all 8 events under the heading opens your Events Page with the search filled in, when that page has an Events block in the Agenda or Hybrid layout that lists upcoming events from every category, with Search Box on. Without one, the section has no link.

This needs Dirigible theme 5.31.489 or later; with an older theme, events show among the other results as before.

Category pages: each Event Category has its own page listing that category's upcoming events, then its past events, newest first. Past events show 12 at a time, with Older events and Newer events links to page through the rest.

Related guides

  • Recurring events — weekly classes, monthly meetups, and concert residencies
  • Ticketing — sell tickets through WooCommerce when site ticketing is enabled
  • Post Types → Events — full field reference for Event Information and Event Meta

Built by Dirigible Studio. Get in touch