What Is Event Schema?

Published
14 min read

What Is Event Schema?

Event schema is structured data that describes a real scheduled event, including its name, start and end times, venue or attendance mode, status, organizer, performers, images and ticket offers.

The Event type covers concerts, conferences, workshops, festivals, sports and other scheduled experiences, with more specific subtypes available. One canonical leaf page should describe one event or performance in enough detail for a person to decide whether and how to attend.

Markup does not turn business hours, discounts, travel packages or ordinary product availability into events. It cannot verify that tickets exist, force a search feature or rescue inaccurate dates and venues. Every structured fact must match the visible event and operational systems.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
What Is Event Schema? reference table
PropertyRepresentsEvidence source
nameSpecific event titlePublished program
startDateEvent start with timezoneScheduling system
endDateEvent endScheduling system
locationVenue or supported event locationVenue contract or platform
eventAttendanceModeOffline, online or mixed formatEvent operations
eventStatusScheduled, moved, postponed or canceled stateOrganizer decision
organizerEntity responsible for eventEvent record
performerFeatured participantProgram agreement
offersTicket or registration accessTicketing system
  • Model one real scheduled event.
  • Use operational dates, venue and status.
  • Connect only genuine tickets and organizers.

Primary specification: Schema.org definition for Event.

Event schema is a machine-readable schedule for a genuine attendable experience, not a promotional wrapper for products or recurring business activity.

How Does Event Schema Work?

Event schema works by creating one event identity on a canonical detail page and connecting its schedule, location, attendance mode, status, organizer, participants and registration offers.

A parser reads the name, start time and location, then evaluates supporting properties such as image, description and offers. A physical venue uses Place and PostalAddress. Schema.org also defines VirtualLocation and mixed attendance, although individual search features can support a narrower subset.

Syntax validation cannot prove the venue is booked, the organizer authorized the listing or a ticket remains available. Event, venue and ticketing systems must stay synchronized. Updates should change status and schedule without silently replacing the event identity.

  • The exact page, asset, entity or relationship covered by this section
  • The live implementation rather than an editor-only preview
  • The primary specification or first-party record defining the expected behavior
  • The validation result, accountable owner and review date
How Does Event Schema Work? reference table
StageGraph actionFailure example
CreateAssign event ID and URLSeries page used as one event
ScheduleSet dated start and endTimezone omitted
LocateConnect real venueCity used without street address
ClassifyChoose event subtype and attendance modeWebinar presented as physical
SellConnect accurate OfferSold-out ticket shown available
UpdateChange status and previous datePostponed event duplicated
ClosePreserve truthful completed or canceled stateOld registration remains active
  1. Confirm a single public event.
  2. Assign canonical identity and schedule.
  3. Map venue and attendance mode.
  4. Connect organizer and ticket source.
  5. Maintain status through completion.

The graph works when one stable event entity mirrors the schedule, access and status users see on the canonical page.

Which Event Schema Properties Matter Most?

The core Event properties are a specific name, startDate and a detailed physical location for current Event Search eligibility, followed by endDate, status, attendance mode, image, description, organizer and offers.

The event name should contain the actual title rather than generic labels, prices, URLs or calls to action. Date values need ISO 8601 formatting and a timezone offset when time is known. A physical Place should include the venue name and complete address.

Use the most specific truthful event subtype. Connect the organizer through the business identity described in Organization schema. Optional data is useful only when it stays synchronized with the registration and scheduling source.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
Which Event Schema Properties Matter Most? reference table
PropertyPriorityAudit question
nameRequired for supported event experienceIs it a specific visible title?
startDateRequiredDoes time and timezone match operations?
locationRequired for current supported experienceIs the full physical venue accurate?
endDateUsefulDoes it represent real completion?
eventStatusHigh lifecycle valueIs the latest operational state shown?
eventAttendanceModeUseful Schema.org contextIs format offline, online or mixed?
imageRecommendedIs it representative and accessible?
descriptionRecommendedCan users understand the event?
offersRecommended for registrationDoes ticket access work?
  • Use a unique descriptive event name.
  • Publish exact timezone-aware dates.
  • Verify venue and ticket access.

Prioritize specific identity, time and place before enriching an event with media, participants and ticket details.

How Should Event Dates and Time Zones Be Marked Up?

Event dates should use ISO 8601 values with the local time and UTC offset, preserving start, end and any previous start date when an event is rescheduled or postponed.

Timezone handling is essential for US events because daylight saving rules can change the offset. The schedule source should store a time-zone identifier and generate the correct offset for the event date rather than hardcoding a winter offset for a summer event.

A multi-day event can use one start and end when admission covers the continuous program. Separate performances with distinct tickets or attendance choices should use separate Event entities. Do not use an all-day date when the event has a known public start time.

  • The exact page, asset, entity or relationship covered by this section
  • The live implementation rather than an editor-only preview
  • The primary specification or first-party record defining the expected behavior
  • The validation result, accountable owner and review date
How Should Event Dates and Time Zones Be Marked Up? reference table
Schedule caseMarkup approachQuality check
One timed sessionStart and end DateTime with offsetMatches visible local time
All-day eventDate when genuinely all dayNo hidden start time
Multi-day conferenceOpening start and final endOne continuous program
Separate ticketed performancesSeparate Event per performanceEach has unique URL or identity
Postponed eventStatus plus previousStartDate when knownNew date handled truthfully
Rescheduled eventUpdated start/end and appropriate statusSame event identity retained
Canceled eventEventCancelled statusDo not erase history silently
Daylight saving boundaryCorrect offset for each dateNo fixed-zone assumption
  1. Store the event’s local time zone.
  2. Generate the correct date-specific offset.
  3. Separate distinct ticketed performances.
  4. Preserve previous dates on reschedule.
  5. Test displayed and structured time together.

Accurate timezone-aware dates let users understand when the event occurs and prevent schedule ambiguity across regions and daylight changes.

How Should Online and Hybrid Events Be Handled?

Schema.org can describe online and mixed events with eventAttendanceMode and VirtualLocation, but current Google Event Search guidance requires a physical component, so online-only events should not be promised that specific visibility.

An online webinar can still be modeled semantically as an Event with OnlineEventAttendanceMode and a controlled access location. A hybrid conference can include both a Place and VirtualLocation with MixedEventAttendanceMode. Keep private access URLs out of public markup when registration is required.

Search consumers differ. Generic schema validity does not establish eligibility for every event experience. Teams should document why they maintain online event markup and measure actual discovery rather than repeating outdated screenshots or unsupported CTR forecasts.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
How Should Online and Hybrid Events Be Handled? reference table
Attendance modelSchema.org representationCurrent Event Search expectation
Physical-only eventOfflineEventAttendanceMode plus PlacePotentially eligible when other rules pass
Online-only webinarOnlineEventAttendanceMode plus VirtualLocationNot supported by current physical-event experience
Hybrid conferenceMixedEventAttendanceMode plus Place and VirtualLocationPhysical component may support eligibility
Private stream URLUse registration or safe public routeDo not expose access token
Recorded on-demand videoVideoObject, not scheduled event by defaultNot a live event
Recurring office hoursSeparate scheduled sessions when realBusiness hours are not events
Virtual product demo sessionOnline Event when genuinely scheduledNo physical-event promise
Livestream with venue audienceMixed mode when both are realVenue and online facts must agree
  • Model actual attendance mode.
  • Protect private streaming access.
  • Never equate valid schema with feature eligibility.

Use accurate online or mixed Schema.org modeling, while separating semantic validity from the physical-location rules of a specific search feature.

How Should Event Tickets and Offers Be Marked Up?

Event offers should describe a real ticket or registration path with an accurate URL, price, currency, availability and sale timing that match the visible event page.

A free event can use a zero price when registration or attendance is genuinely free. A waitlist is not InStock, and a sold-out event should update availability promptly. Multiple ticket tiers can be represented when the page and consumer support them without mixing benefits or dates.

Do not put promotional phrases in the event name. Early-bird pricing needs valid dates and replacement when it expires. Ticket URLs should reach the specific event offer rather than a generic homepage, broken checkout or private administrative route.

  • The exact page, asset, entity or relationship covered by this section
  • The live implementation rather than an editor-only preview
  • The primary specification or first-party record defining the expected behavior
  • The validation result, accountable owner and review date
How Should Event Tickets and Offers Be Marked Up? reference table
Ticket caseMarkup approachQuality check
Free registrationOffer with price 0 and currencyNo hidden mandatory fee
Paid general admissionExact price and currencyCheckout matches
Multiple tiersDistinct Offers when supportedBenefits and inventory remain clear
Early-bird ticketOffer validity datesExpired price removed
Sold outOutOfStock or appropriate availabilityRegistration cannot proceed
WaitlistTruthful availability and page languageNot presented as guaranteed ticket
At-door salesRepresent only when operationally supportedAvailability is current
Third-party ticketingSpecific authorized Offer URLEvent identity and price agree
  1. Identify the public ticket inventory.
  2. Set price, currency and availability.
  3. Connect the event-specific checkout.
  4. Expire promotional offers on time.
  5. Test registration from a clean session.

Offer markup is useful only when price, availability and registration destination describe the ticket a user can actually obtain.

How Should Event Status Changes Be Managed?

Event status should change when the event is canceled, postponed, rescheduled or moved online, while the page preserves clear user guidance and avoids creating duplicate event identities.

Cancellation does not always require deleting the page. Keeping the canonical event page with EventCancelled can help ticket holders understand what happened. Postponed events may lack a new date; communicate uncertainty visibly instead of inventing a placeholder schedule.

When a date changes, retain the same event identity and use previousStartDate where appropriate. If the venue or attendance mode changes, update location and access details together. Ticket refunds and new registration terms belong in visible user guidance.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
How Should Event Status Changes Be Managed? reference table
ChangeeventStatus approachPage action
CanceledEventCancelledExplain cancellation and ticket policy
Postponed without new dateEventPostponedRemove false new date
RescheduledAppropriate rescheduled status and previous dateShow old and new schedule
Moved onlineEventMovedOnline where supported by modelUpdate attendance and access
Venue changeScheduled status may remainReplace Place and directions
Sold outOffer availability changeKeep event schedule truthful
CompletedPast dates and inactive offersPreserve archive if useful
New separate performanceNew Event identityDo not overwrite original occurrence
  • Keep the canonical event identity stable.
  • Update status, date, venue and tickets together.
  • Preserve clear attendee guidance.

Status markup should preserve event identity and communicate the exact operational change users need to act on.

What Event Schema Mistakes Are Common?

Common Event schema mistakes include marking promotions or business hours as events, using generic names, omitting time zones, publishing incomplete addresses, duplicating recurring sessions and leaving canceled or sold-out data stale.

Calendars often generate one Event node on a list page and another on the detail page with different IDs. Recurring series can collapse many independently ticketed dates into one range. Ticket platforms and organizer sites may also disagree about price, status or venue.

Events must be real and publicly attendable under the applicable feature rules. Membership-only, invitation-only or misleading listings should not be promoted as generally bookable. Validation cannot prove admission, authorization or operational status.

  • The exact page, asset, entity or relationship covered by this section
  • The live implementation rather than an editor-only preview
  • The primary specification or first-party record defining the expected behavior
  • The validation result, accountable owner and review date
What Event Schema Mistakes Are Common? reference table
MistakeUser or SEO riskCorrection
Coupon marked as EventWrong resource modelUse offer or promotion context
Business hours marked as EventArtificial schedule entitiesUse LocalBusiness hours
Generic name such as WebinarPoor event identityUse specific public title
Timezone missingWrong attendance timeAdd date-specific offset
City-only locationVenue ambiguityUse complete Place and address
Series collapsed into one EventTicket and date confusionSeparate occurrences
Canceled event remains scheduledFailed attendanceUpdate eventStatus
Private stream link exposedAccess and security leakUse safe registration route
  1. Confirm each item is a genuine event.
  2. Reconcile names, dates and time zones.
  3. Verify venue, attendance and offers.
  4. Separate independently ticketed occurrences.
  5. Test cancellation and reschedule states.

Event markup fails when the scheduled experience, time, place, access or lifecycle is false, fragmented or stale.