Events

Updated

Usage

The Events block shows your events anywhere on your site. A new Events block starts as Hybrid: one what's-on page with List, Month, Week and Day views, search and filters, and page numbers. For a smaller list or a grid on another page, pick List, Cards, Mini, or Agenda under Display As. Choose upcoming, past, ongoing, future, or all events, and optionally narrow it to certain Event Categories.

Use it for a venue's what's-on page, tour dates, class schedules, fundraisers, or conference agendas. Blocks added before Hybrid keep the layout they were set to.

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. Hybrid doesn't have it: it always shows pages of Events Per Page.

Appearance

  • Display As — Hybrid (a new block's layout: list and calendar views on one page, see below), List (image + copy side by side), Cards (responsive grid; the layout of a block that never had one picked), Mini (compact grid), or Agenda (the Hybrid list without its calendar views, see below)
  • Columns — 1–5 per row for Cards and Mini, and for Hybrid's Cards view (default 3)
  • Title Style — text style for event titles
  • Title Heading Level — the heading level of each event title (h2–h5, default h3). Pick one level below the heading above the block, h2 when the page title is the only heading above it, so screen readers get the page outline in order. It doesn't change how titles look; Title Style does that.
  • 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. Hybrid and Agenda have their own Address choice instead (see below).

Hybrid

Hybrid is a whole what's-on page in one block, and the layout a new Events block starts with. Above the events, visitors switch between views:

  • List — the events in date order, laid out as the Agenda below: a date badge, the time, title, venue and address, excerpt, ticket line and image, under month headings. The list comes in pages of Events Per Page (default 12) with page numbers underneath, styled like your blog's.
  • Month — a month grid. Each day shows its events by time and title; a busy day shows the first few and a +N more link to that day. An event that spans several days shows on each of them. A month with nothing in it says so and links to the next event.
  • Week — the week's seven days side by side, each with its events. On a phone the days stack, so nothing is squeezed.
  • Day — one day's events in full, in time order.
  • Cards (off by default) — the events as a card grid, as the Cards layout shows them.
  • Map (off by default) — the upcoming events on a map, one pin for each place, with the places listed under it: name, address and next five dates. A pin opens the place's next dates, and Show on map under a place finds its pin. It needs Dirigible Locations with Enable Mapping on, and uses the same map as the Location Map block (the map service, style and cookie prompt set under Locations → Settings → Maps). Only events linked to a Location with a map pin appear on it (from the next 300 events); a line under the map says how many others there are and links to the list. The search, category and quick choices work on the map too.

Today, and the previous and next arrows, move through months, weeks or days, and the line beside them says which dates are showing ("December 2026"). Under the list, a Past events link shows the events that have already happened, and Upcoming brings the visitor back.

With Search Box, Category Filter or Date Filter on, a bar above the views has a search box, a category choice or a From date. Quick choices above the list, Today, This weekend, This week, and Free with Free Filter on, narrow it in one tap. Free lists events with Free event on or a Cost of Free or 0; leave it off where it wouldn't narrow anything, such as a list of trade shows. The From date opens a small calendar in your site's colours: pick a day, or use Today and Clear. From the keyboard, the arrow keys move between days, Enter picks one and Escape closes it. Without JavaScript, visitors get the browser's own date field. Each filter in use shows as a chip ("Music ×") that clears it. A search matches an event's title, excerpt and description, the same in every view. Categories show as coloured chips, in the same colour as their events in Month and Week, so a category reads the same in every view. Only categories with an upcoming event are offered (on past events, ones with a past event), so no chip leads to an empty list; a category link a visitor arrives with still filters, shown as the current chip.

On each date of a repeating event, View series lists all that series' dates, with a chip naming the series and how often it repeats. With Group Series on, a repeating event takes one row in an upcoming list, at its next date, with a + 10 more dates link to the rest, so a weekly quiz doesn't fill the page; Month, Week and Day still show every date.

With Subscribe Link on, a list showing one repeating event (its View series list) or one category (a category chip, or a block set to a single category under Content) has a line under it: "Add Trivia Night to your calendar: Apple or Outlook · Google Calendar". Visitors subscribe once and their calendar app keeps the dates up to date on its own as you add, move or cancel them, with each event's time, venue, description and a link back to its page. Only published events are in it.

For events that sell tickets on the site, the list and the Month, Week and Day views show the live count when the page opens ("5 tickets left", Sold out, or Sales closed), and mark events that are sold out or down to their last ten tickets so they stand out. The Cards view shows no count. Every view, page, filter and series is a plain page address, so a visitor can bookmark or share "Music in December" and it opens just as they saw it. The page also works with JavaScript turned off; with it on, switching views happens in place, without reloading the page.

The Hybrid panel has:

  • Views — which views visitors can switch to: List, Month, Week, Day (all on for a new block), Cards and Map (shown when Dirigible Locations is active). List is always on.
  • Default View — the view the page opens on
  • Events Per Page — how many events each page of the list shows (1–48, default 12)
  • View Series Link — the View series link on each date of a repeating event (on by default)
  • Group Series — one row per repeating event in the list, at its next date, with a link to its other dates (off by default)
  • Subscribe Link — calendar subscribe links under a list of one series or one category (off by default)
  • Partner Embed — lets other websites show this block's upcoming events (off by default; see Partner embed below)
  • Lobby Screen — today's and tomorrow's events full screen, for a TV (off by default; see Lobby screen below)
  • My Picks — a star on each event so visitors can keep their own list (off by default; see My picks below)
  • Happening Now — labels like Happening now and Tonight on events, and a Next up line (off by default; see Happening now below)
  • Month Separators, Image Position, Excerpt Length, Show Tickets / Ticket Link Text, Search Box, Category Filter, Date Filter and Free Filter, as the Agenda has them (below)

Under Appearance, Hybrid uses the Agenda's Address choice and Show Venue. A Hybrid page replaces a separate Events Calendar page: there's no List | Calendar switch to set up, and it loads less than a calendar page does.

Agenda

Agenda is the Hybrid list on its own, without the Month / Week / Day switch. It has the same bar, quick choices, chips, From date calendar, View series and Past events link as Hybrid's list (above). 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.

How many events it shows follows Limit Events: off, every event in one list; on, the first Events To Show; on with Page Numbers, pages of Events To Show each with page numbers below.

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 of the automatic excerpt to show (default 30; 0 shows it all). An excerpt you wrote in the event's Excerpt box shows whole, so door times and lineups are never cut short.
  • 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 — the bar above the list: a search box, a category choice (only the categories chosen under Content, when any are, and only those with an event to show; eight or fewer show as chips) and a From date
  • Free Filter — a Free quick choice beside Today, This weekend and This week that lists only free events (Free event on, or a Cost of Free or 0); off by default
  • Page Numbers — pages of Events To Show each, with page numbers below (needs Limit Events)
  • View Series Link — the View series link on each date of a repeating event (on by default)
  • Group Series, Subscribe Link, Partner Embed, Lobby Screen, My Picks, Happening Now — as Hybrid has them (above); all off by default
  • 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. Hybrid has its calendar views built in.

Partner embed

With Partner Embed on, a tourism board, a partner venue or a sponsor can show this block's upcoming events on their own website. It works on a block whose Display is upcoming (the default), Ongoing or Future, and one block per page: with two on the same page, the code shares the first one's events. Turn it on, publish the page, and copy the Embed Code under the switch; the partner pastes it where the events should go. Their visitors see a small box with your site's name, the next five events (date, title, time and venue) and an All events at link back to this page; each event opens its page on your site in a new tab.

The box lists the events this block lists: its Display and Event Categories, only published events, and none with a password. To show one category, add &ev_cat= and the category's slug to the address in the code (one of the block's categories); for more or fewer events, add &count= and a number from 1 to 20. The box carries your site's main color and plain system fonts, so it sits quietly on any site. It loads nothing else: no tracking, no cookies and no fonts reach the partner's page, and search engines index your page, not the box. The second line of the code resizes the box to fit the list; without it the box keeps the height it's given and scrolls.

Turning Partner Embed off stops the box everywhere it's pasted: the address shows the normal page again, within about a day on a site that caches pages.

Happening now

With Happening Now on, events in the list (and in Day) carry a small label by their date: Happening now while one is on, Starts in 40 minutes or Starts in 2 hours in the hours before, Tonight or Today for later today, and Tomorrow. Above the first page of upcoming events, a line says what's on or next: "Happening now: Trivia Night", or "Next up · Tonight: Open Mic", linked to the event. Labels follow your site's time zone and each visitor's clock and update every minute, so they're right even on a site that caches its pages. An all-day event reads Today while it's on. An event with no end time reads Today or Tonight once it has started, until midnight.

My picks

With My Picks on, each event in the list (and in Day) has an Add to My picks star, so a visitor planning a festival weekend or a conference can keep their own short list. Once they've starred one, a My picks (3) button sits under the view switch; it opens their list, soonest first, with each event's date, venue and a link, a Remove for each, Clear all, and Add these to your calendar (.ics), a file Apple, Google and Outlook Calendar open. Events that have ended drop off the list on their own, and an event you move shows its new date.

There's no account and nothing is saved on your site: the picks live in the visitor's own browser, on that device, and are shared by every events list on your site. Clearing their browser data clears them. Month, Week, Cards and Map show no stars.

Lobby screen

With Lobby Screen on, the TV behind the bar or in the lobby can show what's on: today's and tomorrow's events, full screen, in your site's colors and fonts, with your Light logo (set beside the logo in the Customizer) or the site name, and a clock. Each event shows its start time (and end), title, venue and featured image; the one happening now is marked Now, and events drop off as they end. When there are more than fit, the screen pages through them every ten seconds. It works on a block whose Display is upcoming (the default), Ongoing or Future, and lists that block's Event Categories: only published events, and none with a password.

Turn it on, publish the page, and open the Screen Address shown under the switch (the page's address with ?ev_view=screen) in the TV's browser; click the screen once to fill it, then leave it running. It checks for changes every hour on its own, without reloading the page, so an event you add or move shows up within the hour. If the connection drops, it keeps showing what it has. Nothing else loads on it: no tracking, no cookie prompt and no other scripts, and search engines don't index it.

Turning Lobby Screen off returns the address to the normal page, within about a day on a site that caches pages.

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. This holds for Hybrid too.

For search engines, a page with a Hybrid or Agenda list of upcoming events also lists its events' addresses in the page's structured data (the first page of the list as set, one entry per repeating event). Each event's full details stay on its own page.

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, use Hybrid, a new block's layout: list, month, week and day views, search, filters and page numbers on one page. Turn on Search Box, Category Filter and Date Filter for a busy venue.
  • If visitors mostly want the calendar, set Default View to Month.
  • For a short "coming up" strip on the home page, use Cards or Mini with Limit Events.
  • For a month grid on its own, use Events Calendar. To promote one date, use Event Countdown.

Settings

Content

Display

Default shows ongoing and upcoming events. For separate upcoming and past sections, use two Events blocks.

  • Default (Ongoing & Future)default
  • Ongoing
  • Past
  • Future
  • All
Preferred Image

Choose whether each card uses the featured image or the video thumbnail first. If an event is missing one, the block uses the other.

  • Featured Imagedefault
  • Video
Limit Events

Leave off to show every matching event. Not in Hybrid, which always shows pages of Events Per Page.

Off by default.

Events To Show

Appears when Limit Events is on.

1 to 50. Default 3.

Appearance

Display As

Hybrid, a new block's layout, is a what's-on page with List, Month, Week and Day views (and optional Cards), search, filters and page numbers. List puts the image beside the text. Cards is a grid. Mini is a compact grid for tight spaces. Agenda is the Hybrid list on its own, without the Month, Week and Day views: month separators, a date badge, the time, venue and address, excerpt, image and ticket line, with optional search, category and date filters and page numbers.

  • Hybrid
  • List
  • Cardsdefault
  • Mini
  • Agenda
Columns

Cards or Mini items per row, and Hybrid's Cards view.

  • 1
  • 2
  • 3default
  • 4
  • 5
Title Style

Mini lists often use Small or Hidden so the dates stand out.

  • Defaultdefault
  • h1
  • h2
  • h3
  • h4
  • h5
  • h6
  • p
  • strong
  • small
  • hidden
Title Heading Level

The heading level of each event title, for screen readers. Pick one level below the heading above this block (h3 under an h2, h2 when only the page title is above). Title Style still sets how titles look.

  • h2
  • h3default
  • h4
  • h5
Date Style

Mini uses Small by default. Pick a heading size when the date matters most.

  • Defaultdefault
  • h1
  • h2
  • h3
  • h4
  • h5
  • h6
  • p
  • strong
  • small
  • hidden
Image
  • Defaultdefault
  • Show
  • Hide
Image Aspect Ratio

Crops event photos to one shape so cards line up. None keeps each photo's original shape.

  • Defaultdefault
  • None
  • 1:1
  • 1:2
  • 2:1
  • 4:3
  • 9:16
  • 16:9
Excerpt

The excerpt is a good place for door times, lineups, or ticket notes.

  • Defaultdefault
  • Normal
  • Small
  • Hide
Link

Hide the link when the whole card is already clickable.

  • Defaultdefault
  • Button
  • Understated
  • Hide
Link Text

Default "See Event."

Link Entire Card

Makes the whole card clickable. The link text still shows unless Link is hidden.

Off by default.

Spacing

Space between events.

  • Defaultdefault
  • None
  • XS
  • SM
  • MD
  • LG
  • XL
Address

Agenda and Hybrid, after the venue name. Full (the default) prints the street, city, state and zip; Choose Parts uses the Show Street / City / State / Zip toggles; Hide leaves the address out.

  • Fulldefault
  • Choose Parts
  • Hide
Show Address

Shows the venue location under each date. City and state are often enough for tour dates. Hybrid and Agenda have their own Address choice instead.

Off by default.

Show Street

Appears when Show Address is on.

Off by default.

Show City

Appears when Show Address is on.

On by default.

Show State

Appears when Show Address is on.

On by default.

Show Zip

Appears when Show Address is on.

Off by default.

Show Venue

Agenda and Hybrid. The venue name in bold before the address: the linked location’s name, or the event’s Venue field.

On by default.

Hybrid

Default View

Hybrid only. The view the page opens on. Only the views ticked under Views can be picked.

Events Per Page

Hybrid only. How many events each page of the list shows, with page numbers below it.

1 to 48. Default 12.

Month Separators

Agenda and Hybrid. A month heading (October 2026) above the first event of each month.

On by default.

Image Position

Agenda and Hybrid. Which side of the text the image sits on at desktop widths; on phones it sits above the text.

  • Rightdefault
  • Left
Excerpt Length

Agenda and Hybrid. How many words of the automatic excerpt to show; 0 shows it all. An excerpt you wrote shows whole.

0 to 100. Default 30.

Show Tickets

Agenda and Hybrid. A ticket line under the excerpt: the Ticket URL as a link, the Cost field or Free, and for tickets sold on the site the price and how many are left.

On by default.

Ticket Link Text

Agenda and Hybrid. The ticket link’s wording. An event’s own Buy button text, set in its Ticketing panel, wins.

Search Box

Agenda and Hybrid. A keyword search box above the events. Searches event titles, excerpts and content.

Off by default.

Category Filter

Agenda and Hybrid. A category choice above the events, limited to the categories picked under Content when any are. Only categories with an upcoming event are offered (with a past one, on past events), so no choice leads to an empty list.

Off by default.

Date Filter

Agenda and Hybrid. A From date box to jump ahead in the list, with a Today link back.

Off by default.

Free Filter

Hybrid and Agenda. A Free quick choice beside Today, This weekend and This week that lists only free events: Free event on, or a Cost of Free or 0. Off by default.

Group Series

Hybrid and Agenda. A repeating event takes one row in the list, at its next date, with a + 10 more dates link to its other dates. Month, Week and Day still show every date. Off by default.

Subscribe Link

Hybrid and Agenda. When the list shows one repeating event or one category, links under it add all its dates to Apple, Outlook or Google Calendar, which then keep them up to date. Off by default.

My Picks

Hybrid and Agenda. A star on each event in the List and Day views; visitors' starred events gather under a My picks button, with a calendar file of them. Picks stay in each visitor's browser. Off by default.

Happening Now

Hybrid and Agenda. Labels like Happening now, Starts in 40 minutes, Tonight and Tomorrow on events in the List and Day views, and a Next up line above the list, set by each visitor's clock so they're right on a cached page. Off by default.

Partner Embed

Hybrid and Agenda. Lets other websites show this block's next events in a small box that links back to your event pages. Once it's on, copy the Embed Code below it for the partner to paste. Off by default.

Lobby Screen

Hybrid and Agenda. Today's and tomorrow's events full screen at the Screen Address below it, for a TV in the lobby or behind the bar. It keeps itself up to date. Off by default.

Agenda

Month Separators

Agenda and Hybrid. A month heading (October 2026) above the first event of each month.

On by default.

Image Position

Agenda and Hybrid. Which side of the text the image sits on at desktop widths; on phones it sits above the text.

  • Rightdefault
  • Left
Excerpt Length

Agenda and Hybrid. How many words of the automatic excerpt to show; 0 shows it all. An excerpt you wrote shows whole.

0 to 100. Default 30.

Show Tickets

Agenda and Hybrid. A ticket line under the excerpt: the Ticket URL as a link, the Cost field or Free, and for tickets sold on the site the price and how many are left.

On by default.

Ticket Link Text

Agenda and Hybrid. The ticket link’s wording. An event’s own Buy button text, set in its Ticketing panel, wins.

Search Box

Agenda and Hybrid. A keyword search box above the events. Searches event titles, excerpts and content.

Off by default.

Category Filter

Agenda and Hybrid. A category choice above the events, limited to the categories picked under Content when any are. Only categories with an upcoming event are offered (with a past one, on past events), so no choice leads to an empty list.

Off by default.

Date Filter

Agenda and Hybrid. A From date box to jump ahead in the list, with a Today link back.

Off by default.

Free Filter

Hybrid and Agenda. A Free quick choice beside Today, This weekend and This week that lists only free events: Free event on, or a Cost of Free or 0. Off by default.

Page Numbers

Agenda only. Page Numbers: pages of Events To Show each, with page numbers below. Needs Limit Events on.

Off by default.

Group Series

Hybrid and Agenda. A repeating event takes one row in the list, at its next date, with a + 10 more dates link to its other dates. Month, Week and Day still show every date. Off by default.

Subscribe Link

Hybrid and Agenda. When the list shows one repeating event or one category, links under it add all its dates to Apple, Outlook or Google Calendar, which then keep them up to date. Off by default.

My Picks

Hybrid and Agenda. A star on each event in the List and Day views; visitors' starred events gather under a My picks button, with a calendar file of them. Picks stay in each visitor's browser. Off by default.

Happening Now

Hybrid and Agenda. Labels like Happening now, Starts in 40 minutes, Tonight and Tomorrow on events in the List and Day views, and a Next up line above the list, set by each visitor's clock so they're right on a cached page. Off by default.

Partner Embed

Hybrid and Agenda. Lets other websites show this block's next events in a small box that links back to your event pages. Once it's on, copy the Embed Code below it for the partner to paste. Off by default.

Lobby Screen

Hybrid and Agenda. Today's and tomorrow's events full screen at the Screen Address below it, for a TV in the lobby or behind the bar. It keeps itself up to date. Off by default.

Calendar Page Link

Agenda only. The address of a page with the Events Calendar block adds a List | Calendar switch above the list. Hybrid has Month, Week and Day built in.

Live Preview

Good Vibes

September 2, 2022 - September 19, 2030

Get ready to soak in the sunshine of positivity, dance to the rhythms of joy, and spread good vibes all around at our Madison "Good Vibes" Celebration! This event is a joyful gathering of like-minded individuals, where you can bask in the warmth of positive energy, connect with others, and celebrate the beauty of life.

Writing Workshop

November 13, 2027

Are you passionate about storytelling, eager to refine your writing skills, or simply curious about the creative writing process? Join us for a captivating journey of words and inspiration at our Writing Workshop in the heart of Wisconsin.

Violin Workshop

September 13, 2028

Discover the enchanting world of music and master the art of violin playing at our immersive Violin Workshop in the vibrant city of Madison. Whether you're an aspiring violinist or a seasoned musician, this event promises a harmonious journey filled with learning, creativity, and the joy of making music.

Built by Dirigible Studio. Get in touch