Event Schema Reference

Technical reference for Schema.org Event structured data. Used by Google for event rich results, calendar integration, and enhanced search visibility.

Schema.org Event

Event schema represents any type of event including concerts, conferences, webinars, festivals, and performances. Google supports Event rich results showing event details, dates, locations, and ticket information directly in search results.

Rich Results Support: Google displays Event data in search results with date/time, location, and ticket information. Events may also appear in Google Calendar and Maps integration.

JSON-LD Implementation

Physical Event Example

{
  "@context": "https://schema.org",
  "@type": "Event",
  "name": "Summer Music Festival 2024",
  "description": "Three-day outdoor music festival featuring top indie artists with food trucks and craft beer garden",
  "image": [
    "https://festival.com/hero-image.jpg",
    "https://festival.com/stage-photo.jpg"
  ],
  "startDate": "2024-07-15T18:00",
  "endDate": "2024-07-17T23:00",
  "eventStatus": "https://schema.org/EventScheduled",
  "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
  "location": {
    "@type": "Place",
    "name": "Riverside Park",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "123 River Road",
      "addressLocality": "Springfield",
      "addressRegion": "IL",
      "postalCode": "62701",
      "addressCountry": "US"
    },
    "geo": {
      "@type": "GeoCoordinates",
      "latitude": 39.7817,
      "longitude": -89.6501
    }
  },
  "organizer": {
    "@type": "Organization",
    "name": "MusicFest Productions",
    "url": "https://musicfest.com"
  },
  "performer": [
    {
      "@type": "MusicGroup",
      "name": "The Indie Collective"
    },
    {
      "@type": "Person",
      "name": "Sarah Johnson"
    }
  ],
  "offers": {
    "@type": "Offer",
    "url": "https://festival.com/tickets",
    "price": "89.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "validFrom": "2024-01-01"
  }
}

Virtual Event Example (Webinar)

{
  "@context": "https://schema.org",
  "@type": "Event",
  "name": "Advanced SEO Techniques Webinar",
  "description": "Learn advanced SEO strategies for 2024 from industry experts. Live Q&A session included.",
  "startDate": "2024-02-15T14:00",
  "endDate": "2024-02-15T16:00",
  "eventStatus": "https://schema.org/EventScheduled",
  "eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
  "location": {
    "@type": "VirtualLocation",
    "url": "https://zoom.us/j/123456789"
  },
  "organizer": {
    "@type": "Organization",
    "name": "SEO Institute",
    "url": "https://seoinstitute.com"
  },
  "performer": {
    "@type": "Person",
    "name": "Dr. Jane Smith",
    "jobTitle": "SEO Director"
  },
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "validFrom": "2024-01-01"
  }
}

Required Properties

@context

Must be "https://schema.org"

@type

Must be "Event"

name

Event title or name

startDate

Event start date and time in ISO 8601 format

Example: "2024-07-15T18:00"

location

Event location (Place for physical, VirtualLocation for online)

  • • Physical events: Use Place with address and geo coordinates
  • • Virtual events: Use VirtualLocation with URL

Recommended Properties for Rich Results

Event Details

  • description - Event description
  • image - Event image or poster
  • endDate - Event end date/time
  • eventStatus - Event status (Scheduled, Cancelled, etc.)

Attendance Mode

  • eventAttendanceMode - Online, offline, or mixed
  • maximumAttendeeCapacity - Venue capacity
  • remainingAttendeeCapacity - Available spots

People & Organizations

  • organizer - Event organizer
  • performer - Artists, speakers, performers
  • contributor - Additional contributors

Tickets & Pricing

  • offers - Ticket pricing and availability
  • doorTime - Venue opening time
  • typicalAgeRange - Age restrictions

Event Status Values

Active Events

  • https://schema.org/EventScheduled - Event is scheduled
  • https://schema.org/EventPostponed - Event postponed
  • https://schema.org/EventRescheduled - Event rescheduled

Cancelled Events

  • https://schema.org/EventCancelled - Event cancelled
  • https://schema.org/EventMovedOnline - Moved online

Event Attendance Modes

Offline

Physical, in-person events

OfflineEventAttendanceMode

Online

Virtual events, webinars

OnlineEventAttendanceMode

Mixed

Hybrid events

MixedEventAttendanceMode

Date and Time Formatting

Event dates must use ISO 8601 format. Include time zone information for accurate display:

ISO 8601 Examples

Local Time:
"2024-07-15T18:00"
With Timezone:
"2024-07-15T18:00-05:00"
UTC Time:
"2024-07-15T23:00Z"
Date Only:
"2024-07-15"

Common Date Mistakes

  • • Using MM/DD/YYYY format instead of ISO 8601
  • • Missing time component for timed events
  • • Incorrect timezone formatting
  • • Using 12-hour time format

Common Validation Errors

Missing startDate

Error: startDate is required for all Event schemas

Incorrect: Missing startDate property entirely

Invalid date format

Error: Dates must use ISO 8601 format

"startDate": "July 15, 2024" // Wrong format

Missing location details

Warning: Location should include complete address for physical events

{
  "location": {
    "name": "Convention Center" // Missing address
  }
}

Inconsistent attendance mode

Warning: Virtual events should use VirtualLocation, not physical addresses

{
  "eventAttendanceMode": "OnlineEventAttendanceMode",
  "location": {
    "@type": "Place", // Should be VirtualLocation
    "address": "123 Main St"
  }
}

Event Subtypes

BusinessEvent

Conferences, trade shows, seminars

MusicEvent

Concerts, festivals, performances

SportsEvent

Games, matches, tournaments

EducationEvent

Workshops, courses, training

ExhibitionEvent

Art shows, exhibitions, fairs

Festival

Cultural festivals, celebrations

Validation & Testing

Test Event implementation using these validation tools:

Validate with SchemaValidator
Google Rich Results Test
← Back to Schema Types