eventStatus
eventStatus · Recommended by Google
Appears in
What is it?
The current status of an event: whether it is going ahead as planned, has been cancelled, postponed, rescheduled, or moved online. This property uses a fixed set of values from the EventStatusType enumeration. It becomes critical when plans change, giving search engines and AI systems an immediate signal that an event listing has been updated.
Why this matters for AEO
When a user asks "is [event] cancelled" or "has [concert] been rescheduled," AI answer engines read eventStatus to provide a direct answer. Without this field, the AI must scan page text for cancellation notices, which may be buried in a blog post or social update and easily missed. During disruptions (weather, artist illness, venue issues), eventStatus is the fastest structured signal available.
What the specs say
Schema.org: EventStatusType. An eventStatus of an event represents its status; particularly useful when an event is cancelled or rescheduled. schema.org/eventStatus
Google: Recommended. "The status of the event. If you don't use this field, Google understands it as EventScheduled." Google Event docs
How to find your value
- Going ahead as planned —
https://schema.org/EventScheduled - Cancelled —
https://schema.org/EventCancelled - Postponed (no new date) —
https://schema.org/EventPostponed - Rescheduled (new date set) —
https://schema.org/EventRescheduled - Moved online —
https://schema.org/EventMovedOnline
Format and code
Scheduled event (default behavior, can be omitted):
{
"@type": "Event",
"name": "AWS re:Invent 2024",
"eventStatus": "https://schema.org/EventScheduled",
"startDate": "2024-12-02T08:00:00"
}
Cancelled event (keep the listing live):
{
"@type": "Event",
"name": "Summer Music Fest 2024",
"eventStatus": "https://schema.org/EventCancelled",
"startDate": "2024-07-20T15:00:00"
}
Rescheduled event (include both old and new dates):
{
"@type": "Event",
"name": "B.B. King Live",
"eventStatus": "https://schema.org/EventRescheduled",
"startDate": "2024-05-15T20:00:00",
"previousStartDate": "2024-04-12T20:00:00"
}
Moved online:
{
"@type": "Event",
"name": "Design Systems Summit",
"eventStatus": "https://schema.org/EventMovedOnline",
"eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
"location": {
"@type": "VirtualLocation",
"url": "https://designsystems.com/summit/live"
}
}
When rescheduling, always update startDate to the new date and set previousStartDate to the original date. Do not delete the listing; update the status instead.
Webflow implementation
Static pages
Add or update eventStatus in the Event JSON-LD in Page Settings > Custom Code (Before ):
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Event",
"name": "Webflow Conf 2024",
"eventStatus": "https://schema.org/EventScheduled",
"startDate": "2024-10-09T09:00:00",
"location": {
"@type": "Place",
"name": "Palace of Fine Arts, San Francisco"
}
}
</script>
When an event is cancelled or rescheduled, update this value in the custom code rather than removing the entire schema block.
CMS template pages
Use a CMS option or plain text field to store the status value. Map it to eventStatus in the JSON-LD embed. Update the CMS item when the event status changes.
In Schema HQ
The eventStatus field provides a status dropdown for Event schema. Select the current status and, for rescheduled events, enter the previous start date. The published JSON-LD updates automatically.
Real examples
Eventbrite (Data Saturday Oslo 2025):
"eventStatus": "EventCompleted"
Schema.org (B.B. King rescheduled example):
"eventStatus": "EventRescheduled"
Related fields
- startDate — the current (or new) event date
- endDate — when the event ends
- eventAttendanceMode — update to online when using EventMovedOnline
- location — may change when an event moves online or to a new venue
- organizer — the host responsible for status updates
FAQ
Should I remove a cancelled event page or update the schema?
Update the schema with EventCancelled and keep the page live. Google recommends maintaining the listing so users searching for the event find the cancellation notice rather than a 404 page.
What is the difference between EventPostponed and EventRescheduled?
EventPostponed means the event is delayed but no new date has been set. EventRescheduled means a new date is confirmed. Use EventPostponed first, then switch to EventRescheduled once the new date is announced, updating startDate and adding previousStartDate.
Does Google default to EventScheduled if I omit eventStatus?
Yes. Google's documentation states that if eventStatus is not provided, the event is treated as EventScheduled. You only need to set this field explicitly when the status changes from the default.