Content markup properties of events

This section provides the details of the content markup properties for the Event related entity type.

SportsEvent specification table

Property	Expected Type	Description
`@context`	Text	Required - Always set to `["http://schema.org", {"@language": "xx"}]` Replace `xx` with the entity's language code in BCP 47 format format, for example, "en".
`@type`	Text	Required - Always set to `SportsEvent`.
`@id`	URL	Required - The content's identifier in URI format; for example, https://example.com/1234abc. `@id` must meet the following requirements: Globally unique across your catalog Static In the form of Unified Resource Identifier (URI) Because an entity's `url` meets all the requirements as an identifier, we recommend you use an entity's `url` as `@id`. See the Identifier section for more details.
`name`	Text	Required - The name of this event.
`description`	Text	The description of this event. 300-character limist. Use an array to include the descriptions in multiple languages and lengths.
`startDate`	Date	Required - The start time of the event in ISO 8601 format with time zone.
`endDate`	Date	The end time of the event in ISO 8601 format with time zone.
`homeTeam`	SportsTeam	The home team of the event.
`homeTeam.name`	Text	The full name of the sports team.
`homeTeam.sport`	URL	A link to the English Wikipedia page of the sport.
`homeTeam.athlete`	Person	Annotation(s) for an individual athlete on the team.
`homeTeam.athlete.name`	Text	The full name of the athlete.
`awayTeam`	SportsTeam	The away team of the event. The properties are the same as `SportsEvent.homeTeam`.
`competitor`	SportsTeam or Person	If the home or away team is not applicable (e.g., a boxing match, the Olympics), specify the participants as competitors. If `SportsTeam`, the properties are the same as `SportsEvent.homeTeam`. If `Person`, the properties are the same as other`Person` objects; for instance, an actor in `Movie`.
`location`	Place OR City	Required - The location of the event.
`location.name`	Text	Required - The name of the location.
`location.address`	PostalAddress	Required if location @type is Place - The address of the location. This shouldnt be used if location @type is City
`location.address.streetAddress`	Text	The street address of the location.
`location.address.addressLocality`	Text	The city of the location.
`location.address.addressRegion`	Text	The state of the location.
`location.address.postalCode`	Text	The postal code of the location.
`location.address.addressCountry`	Text	The countries in ISO 3166 format.
`image`	ImageObject	Image(s) related to the event. Recommended to be the official poster or banner art for the event. Provide the highest resolution available. Use a JPEG or PNG file format.
`image.description`	Text	The description of the image. 300-character limit. Use an array to provide the descriptions in multiple languages and lengths.
`image.contentUrl`	URL	A URL where the image can be fetched.
`image.regionsAllowed`	Place	The regions where the image is allowed. If the image is allowed everywhere, do not provide this. Specify the countries in ISO 3166 format.
`potentialAction`	WatchAction	Required if applicable - The deep link that plays the recording of this sports event on Video on Demand. To specify the deep link for a live event, use the `publishedOn` or `potentialAction` property in `BroadcastEvent` instead.

SportsEvent examples

Example 1

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

Example 2

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

MusicEvent specification table

Property	Expected Type	Description
`@context`	Text	Required - Always set to `["http://schema.org", {"@language": "xx"}]` Replace `xx` with the entity's language code in BCP 47 format format, for example, "en".
`@type`	Text	Required - Always set to `MusicEvent`.
`@id`	URL	Required - The content's identifier in URI format; for example, https://example.com/1234abc. `@id` must meet the following requirements: Globally unique across your catalog Static In the form of Unified Resource Identifier (URI) Because an entity's `url` meets all the requirements as an identifier, we recommend you use an entity's `url` as `@id`. See the Identifier section for more details.
`name`	Text	Required - The name of this event.
`description`	Text	The description of the event. 300-character limist. Use an array to include the descriptions in multiple languages and lengths.
`attendee`	Organization or Person	A person or organization attending the event.
`startDate`	Date	Required - The start time of the event in ISO 8601 format with time zone.
`endDate`	Date	The end time of the event in ISO 8601 format with time zone.
`composer`	Organization or Person	The person or organization who wrote a composition, or who is the composer of a work performed at some event.
`performer`	Organization or Person	Required - A performer at the event—for example, a presenter, a musician, musical group or actor.
`subEvent`	Event	An Event that is part of this event. For example, a conference event includes many presentations, each of which is a subEvent of the conference.
`superEvent`	Event	An event that this event is a part of. For example, a collection of individual music performances might each have a music festival as their superEvent.
`location`	Place OR City	Required - The location of the event.
`location.name`	Text	Required - The name of the location.
`location.address`	PostalAddress	Required if location @type is Place - The address of the location. This shouldnt be used if location @type is City
`location.address.streetAddress`	Text	The street address of the location.
`location.address.addressLocality`	Text	The city of the location.
`location.address.addressRegion`	Text	The state of the location.
`location.address.postalCode`	Text	The postal code of the location.
`location.address.addressCountry`	Text	The countries in ISO 3166 format.
`workPerformed`	CreativeWork	A work performed in some event, for example a play performed in a TheaterEvent.

MusicEvent example

MusicEvent

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

Event specification table

Property	Expected Type	Description
`@context`	Text	Required - Always set to `["http://schema.org", {"@language": "xx"}]` Replace `xx` with the entity's language code in BCP 47 format format, for example, "en".
`@type`	Text	Required - Always set to `Event`.
`@id`	URL	Required - The content's identifier in URI format; for example, https://example.com/1234abc. `@id` must meet the following requirements: Globally unique across your catalog Static In the form of Unified Resource Identifier (URI) Because an entity's `url` meets all the requirements as an identifier, we recommend you use an entity's `url` as `@id`. See the Identifier section for more details.
`name`	Text	Required - The name of this event.
`description`	Text	The description of the event. 300-character limist. Use an array to include the descriptions in multiple languages and lengths.
`attendee`	Organization or Person	A person or organization attending the event.
`startDate`	Date	Required - The start time of the event in ISO 8601 format with time zone.
`endDate`	Date	The end time of the event in ISO 8601 format with time zone.
`subEvent`	Event	An Event that is part of this event. For example, a conference event includes many presentations, each of which is a subEvent of the conference.
`superEvent`	Event	An event that this event is a part of. For example, a collection of individual music performances might each have a music festival as their superEvent.
`location`	Place OR City	Required - The location of the event. Note that you can provide `Place` in `City` level.
`location.name`	Text	Required - The name of the location.
`location.address`	PostalAddress	Required if location @type is Place - The address of the location. This shouldnt be used if location @type is City
`location.address.streetAddress`	Text	The street address of the location.
`location.address.addressLocality`	Text	The city of the location.
`location.address.addressRegion`	Text	The state of the location.
`location.address.postalCode`	Text	The postal code of the location.
`location.address.addressCountry`	Text	The countries in ISO 3166 format.
`workPerformed`	CreativeWork	A work performed in some event, for example a play performed in a TheaterEvent.

Event example

Event

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}