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"}]
|
@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:
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 otherPerson 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"}]
|
@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:
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"}]
|
@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:
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"
}
}