Google Event structured data
The Google Event structured data,
as documented
What Google documents, in its own words. Verified from Google's page on 2026-10-09.
Google's page explains how event markup makes events eligible for the event experience on Google. This page lists those statements with the exact wording from Google.
What Google says
| Topic | What Google says | Source |
|---|---|---|
| Event experience | “The event experience on Google makes it easier for people to discover and attend events through Google Search results and other Google products, like Google Maps.” | Google docs Verified 2026-10-09 |
| One event per page | “The event experience on Google only supports pages that focus on a single event.” | Google docs Verified 2026-10-09 |
| Unique URL | “Each event MUST have a unique URL (a leaf page) and markup on that URL.” | Google docs Verified 2026-10-09 |
| Multi-day events | “If your event or ticket info is for an event that runs over several days, specify both the start and end dates of the event.” | Google docs Verified 2026-10-09 |
| Separate performances | “If there are several different performances across different days, each with individual tickets, add a separate Event element for each performance.” | Google docs Verified 2026-10-09 |
| Accuracy | “Each event must accurately describe the event name, start date, and location.” | Google docs Verified 2026-10-09 |
| Public events | “Events must be bookable to the general public.” | Google docs Verified 2026-10-09 |
| Virtual events | “Virtual experiences that have no real-world component aren't supported.” | Google docs Verified 2026-10-09 |
| Timezone | “Specify the timezone by including the UTC or GMT time offset.” | Google docs Verified 2026-10-09 |
| Unknown start hour | “If you don't know the hour for the start time, don't specify a granular hour.” | Google docs Verified 2026-10-09 |
| name | “DO NOT put the name of the event location.”Required property. | Google docs Verified 2026-10-09 |
| startDate | “The start date and start time of the event in ISO-8601 format.”Required property. | Google docs Verified 2026-10-09 |
| location | “The location of the event. Set the @type to Place. Add the location.address and location.name properties.”Required property. | Google docs Verified 2026-10-09 |
| eventStatus default | “If you don't use this field, Google understands the eventStatus to be EventScheduled.”Recommended property. | Google docs Verified 2026-10-09 |
| Status changes | “When the event status changes, DON'T remove the startDate.”Google gives the reason that startDate identifies the unique event. | Google docs Verified 2026-10-09 |
| Cancelled events | “keep all values as the same as they were before the cancelation, and update the eventStatus to EventCancelled.” | Google docs Verified 2026-10-09 |
| previousStartDate | “If you add previousStartDate, you must also add the eventStatus property and set the eventStatus to EventRescheduled.” | Google docs Verified 2026-10-09 |
| Free events | “If the event is available without payment, fees, or service charges, set the price to 0.”Google gives this for offers.price. | Google docs Verified 2026-10-09 |
| Images | “We recommend that images are 1920px wide (the minimum width is 720px).” | Google docs Verified 2026-10-09 |
| Validation | “Validate your code using the Rich Results Test and fix any critical errors.” | Google docs Verified 2026-10-09 |
How to apply it
A checklist built only from the guidance in Google's page.
- Put Event markup on a page dedicated to one event, with its own URL.
- Add name, startDate and location (a Place with an address and name).
- Give start and end dates in ISO-8601 with a UTC offset, or the date only if the hour is unknown.
- When plans change, update eventStatus and keep startDate and location.
- Validate with the Rich Results Test, then check the page with the URL Inspection tool.
Questions
Can one page list several events?
Google says the event experience only supports pages that focus on a single event, and each event needs a unique URL.
Which properties are required?
Google lists name, startDate and location as required.
What should I do when an event is cancelled?
Google says to keep the other values as they were and update eventStatus to EventCancelled, without removing startDate.
Are online-only events supported?
Google says virtual experiences that have no real-world component aren't supported.
Can I mark up a discount or a business opening hours as an event?
No. Google lists short-term discounts, business hours and coupons among the things not to mark as events.
How current is this page?
Every quote was read from Google's page on 2026-10-09. The page showed "Last updated 2026-09-08 UTC". Google can change its documentation, so treat the linked page as the final word.
Sources
- Event (Event) structured data (Google Search Central), read on 2026-10-09
Let Balzac write the articles.
Type your website. Balzac finds the searches you can win, writes articles built to rank on Google and get cited by ChatGPT, and publishes them for you.
3 free articles · No card needed