Skip to main content

Event Status & Labels

Set event statuses and custom display labels at the event level or per occurrence.

Overview

Events can have a status (Scheduled, Cancelled, Postponed, Rescheduled) and a freeform display label (e.g., "Sold Out", "Almost Full", "Free Entry"). Both can be set globally for the event or overridden for specific occurrences.

Event Status

Available Statuses

StatusDescriptionSchema.org Value
ScheduledNormal/active event (default)EventScheduled
CancelledEvent will not take placeEventCancelled
PostponedEvent delayed, new date TBDEventPostponed
RescheduledEvent moved to a different dateEventRescheduled

Setting Status

Per Event

  1. Edit your event post
  2. In the Recurrence Settings metabox, open the Event Schema tab
  3. Select a status from the Event Status dropdown
  4. Save the event

Per Occurrence

Statuses can also be set per occurrence using overrides:

  1. In the metabox, go to Manage Occurrences
  2. Add or edit an override for a specific date
  3. Set the status for that occurrence

The plugin also auto-detects status from existing data — if an occurrence has been cancelled via the exclusions system, it can reflect that as "Cancelled", and rescheduled dates automatically get the "Rescheduled" status.

Display Labels

Display labels are freeform text fields for frontend badges. Unlike status (which has fixed options and maps to schema.org), labels are completely custom.

Common Examples

  • "Sold Out"
  • "Almost Full"
  • "Free Entry"
  • "New Time!"
  • "Special Guest"
  • "Members Only"

Setting Labels

Labels are configured in the same Event Schema tab as status. Set a label at the event level, or override it for specific occurrences in Manage Occurrences.

Displaying Status & Labels

Bricks Builder Dynamic Tags

TagOutput
{lre_event_status}Human-readable status (e.g., "Cancelled")
{lre_event_status_label}Status formatted for display
{lre_event_label}Custom display label text

These tags work in text elements and can also be used in Bricks conditions to conditionally show/hide elements based on status.

Conditional Display Example

Show a red "Cancelled" badge only for cancelled occurrences:

  1. Add a Div with a styled "Cancelled" text
  2. Set condition: {lre_event_status} equals cancelled

Shortcodes

[lre_status]
[lre_status format="key"]
[lre_status format="schema"]
[lre_label]
ShortcodeOutput
[lre_status]Human-readable status label
[lre_status format="key"]Raw status key (e.g., cancelled)
[lre_status format="schema"]Schema.org value (e.g., EventCancelled)
[lre_label]Custom display label

Calendar Integration

Event status is reflected in the FullCalendar display. Cancelled events can be visually distinguished, and the offcanvas panel shows the current status.

Schema.org Integration

When Schema.org structured data is enabled, event status automatically maps to the correct eventStatus value in the JSON-LD markup. Rescheduled events also include previousStartDate for proper Google rich results.

Extensibility

Hooks

HookTypeDescription
lre_event_statusesFilterAdd or modify available status options
lre_resolved_event_statusFilterModify the resolved status for a specific occurrence
lre_resolved_event_labelFilterModify the resolved label for a specific occurrence

Custom Statuses

Add your own status options:

add_filter('lre_event_statuses', function($statuses) {
$statuses['sold_out'] = __('Sold Out', 'my-theme');
return $statuses;
});