Event schema markup: example, required fields and WordPress setup

JSON-LD example

Copy this into a <script type="application/ld+json"> tag and replace the values with your own.

{
  "@context": "https://schema.org",
  "@type": "Event",
  "name": "Intro to Wheel Throwing: Evening Workshop",
  "startDate": "2026-11-04T18:30-05:00",
  "endDate": "2026-11-04T21:00-05:00",
  "eventStatus": "https://schema.org/EventScheduled",
  "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
  "location": {
    "@type": "Place",
    "name": "Kilnworks Studio",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "88 Foundry Road",
      "addressLocality": "Providence",
      "addressRegion": "RI",
      "postalCode": "02903",
      "addressCountry": "US"
    }
  },
  "image": [
    "https://example.com/images/wheel-throwing-class.jpg"
  ],
  "description": "A hands-on evening workshop on centering clay and pulling your first cylinder. Clay and firing included.",
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/classes/wheel-throwing",
    "price": 65,
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "validFrom": "2026-09-01T09:00-04:00"
  },
  "organizer": {
    "@type": "Organization",
    "name": "Kilnworks Studio",
    "url": "https://example.com"
  }
}

Properties

Venues, hybrid events and changed plans

Google's event experience covers events with a physical location and nothing else. That decides how each format should be marked up:

• In person: a Place with a full PostalAddress. This is the case Google lists.
• Hybrid: the venue as the Place. schema.org lets you add a VirtualLocation for the stream alongside it, but the venue is what makes the page eligible.
• Online only: a webinar can still carry Event markup with a VirtualLocation, and it is valid schema.org, but it will not appear in Google's event listings. For a livestream, VideoObject with a BroadcastEvent is the type Google actually uses, for its LIVE badge.

When plans change, update the markup instead of deleting it:

• Cancelled: set EventCancelled and keep the original startDate.
• Postponed with no new date: set EventPostponed and keep the original startDate until a new one is known.
• Rescheduled: set EventRescheduled, put the new date in startDate and the old one in previousStartDate.
• Moved online: once there is no venue, the event falls outside Google's listings. schema.org's EventMovedOnline still describes the change accurately for other parsers.

Add it in WordPress

By hand. Print JSON-LD from wp_head on each event's page. Event plugins often output their own markup, so check the page source before adding more.

With Hydrogen SEO. Choose Event in the event page's SEO Settings sheet and fill the name, start and end dates, location and offer fields. The plugin renders JSON-LD server-side. Keep dates accurate; expired events still carrying live markup are a common source of Search Console warnings.

One-off markup. The free schema generator in the Hydrogen SEO app at /seo/schema-generator builds Event JSON-LD, including location and ticket offer, from a short form. Its output assumes a scheduled, in-person event, which is the kind Google lists, so edit eventStatus if the date has changed.

Common mistakes

• Marking up things that are not events. Coupons, sales that run for weeks, and business hours are not Events.
• One block for a multi-date series without separate dates. Each occurrence with its own date should be its own Event, ideally with its own page or clearly listed.
• Missing time zone. A startDate without an offset can shift the listed time.
• Venue name as the event name. name is the event, the venue goes in location.
• Deleting markup on cancellation. Set eventStatus instead, so Google can show that it is cancelled.

More: invalid structured data.

Test it

Start offline: the free validator shows which Event fields are missing. After publishing, recheck the real URL in Google's Rich Results Test. Check that the start time in the parsed output is the local time you intended. Search Console's Events report flags errors across all event pages; after an event ends, its markup can come off or stay, but it should never show the wrong status.