Schema generators

Event schema: get your events into Google

Event schema tells Google the name, date, place and ticket details of an event. With it, your events can appear in Google's event listings, which show up for searches like "concerts this weekend".

When someone searches for things to do ("jazz near me", "workshops in Austin this month"), Google often shows a list of upcoming events with dates and venues. Those listings come from Event structured data on event pages, along with ticketing sites that use it.

An event schema example

{
  "@context": "https://schema.org",
  "@type": "Event",
  "name": "Autumn Jazz Night",
  "startDate": "2026-11-21T19:30:00-06:00",
  "endDate": "2026-11-21T22:30:00-06:00",
  "eventStatus": "https://schema.org/EventScheduled",
  "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
  "location": {
    "@type": "Place",
    "name": "The Blue Room",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "45 Main St",
      "addressLocality": "Austin",
      "addressRegion": "TX",
      "postalCode": "78701",
      "addressCountry": "US"
    }
  },
  "image": ["https://example.com/img/jazz-night.jpg"],
  "description": "An evening of live jazz with three local trios.",
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/tickets/jazz-night",
    "price": "25",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "validFrom": "2026-10-01T10:00:00-06:00"
  },
  "organizer": { "@type": "Organization", "name": "Blue Room Events", "url": "https://example.com/" },
  "performer": { "@type": "PerformingGroup", "name": "The Riverside Trio" }
}

Required fields

Google requires three:

  • name: the event's title.
  • startDate: in ISO 8601 format, with a time and time zone where known.
  • location: a Place with a full address, or a VirtualLocation for online events.

Recommended: endDate, eventStatus, image, description, offers, organizer and performer.

Free tool

Event Schema Generator

Add your event's dates, place and tickets, and copy Event JSON-LD that can show in Google's event results.

Free, no sign-up. The code is built in your browser: nothing you type is sent anywhere.

Open the full Event Schema Generator page →

Online and hybrid events

Set eventAttendanceMode to show how people attend:

ModeValue
In personOfflineEventAttendanceMode
OnlineOnlineEventAttendanceMode
BothMixedEventAttendanceMode

For online events, use a VirtualLocation with the URL people join from. For hybrid events, list both a Place and a VirtualLocation.

Cancelled, postponed and rescheduled events

Don't delete the markup when plans change. Update eventStatus:

  • EventCancelled for cancelled events.
  • EventPostponed when there's no new date yet.
  • EventRescheduled with the new startDate (and the old one in previousStartDate).
  • EventMovedOnline when an in-person event goes virtual.

Rules to follow

  1. One event per Event block. A festival with many shows can have one block per show.
  2. Mark up event pages, not adverts. Markup belongs on the page that describes the event itself.
  3. Don't mark up things that aren't events, such as coupons, product launches with no attendance, or business hours.
  4. Remove or update past events. Google stops showing them after the date, but keep your data tidy.

Build and test it

Fill in the generator on this page, copy the JSON-LD into the event page, and check it with the schema checker. If you publish events on a ticketing platform too, the platform's own markup may already cover those listings.

Questions

What fields does event schema require?

Google requires name, startDate and location. endDate, eventStatus, image, description, offers and organizer are recommended.

Can online events use event schema?

Yes. Set eventAttendanceMode to OnlineEventAttendanceMode and use a VirtualLocation with the joining URL.

What should I do with event schema if an event is cancelled?

Keep the page and set eventStatus to EventCancelled, so Google can show the cancellation instead of the old details.

Where do events with schema appear in Google?

In Google's event listings for searches about things to do, and as event details in regular results.

See what to fix on your website today.

Free plan, no credit card. Your first fixes in about a minute.