Event schema

type #

type

@type

Type of the event. Multiple types can be selected.

info #

title

name

The full title of the event.

description

description

Description of the event. Describe all details of the event to make it easier for users to understand and attend the event. Best practices:

  • Add a clear and concise description of the specific event.
  • Focus on the event details and not your site’s features.
  • Don’t repeat other facts like date and location; instead, add that information to the respective properties.

url

url

The URL of the event.

status

eventStatus

The status of the event. Here are the supported values: Cancelled, Moved Online, Postponed, Rescheduled, Scheduled. You can use multiple statuses, if applicable (for example, if an event was both rescheduled and moved online).

start

startDate

The start date and start time of the event.
Add both the date and time so users can more easily find events that fit into their schedule.

end

endDate

The end date and end time of the event.
Add both the date and time so users can more easily find events that fit into their schedule.

location & persons #

type

eventAttendanceMode

Indicates whether the event occurs online, offline at a physical location, or a mix of both online and offline. Use one of the following values: physical, online, mixed.

location

location

The location of the event. There are different requirements depending on if the event is happening online or at a physical location:

  • Physical location: The location.address and location.name properties are required.
  • Online event: The location.url is required.
  • Mix of online and physical locations: If an event has a mix of online and physical location components, include both online and physical location properties.

name

name

The detailed name of the place or venue where the event is being held. This property is only recommended for events that take place at a physical location.

address

address

The venue’s detailed street address. This property is only required for events that take place at a physical location.

url

url

The URL of the online event, where people can join. This property is required if your event is happening online. If the URL to join the event isn’t available until after registering for the event, provide the registration URL where people can take the next steps to join your event.

organizers

organizer

The person or organization that is hosting the event. This is especially important for online events, where there isn’t any venue information.
You can select from a dropdown of available business, organizations and persons, or you can right click on the field and enter a text value or a WikiData reference.

performers

performer

The participants performing at the event, such as artists and comedians.
You can select from a dropdown of available business, organizations and persons, or you can right click on the field and enter a text value or a WikiData reference.

tickets #

prices

offers

You can add several ticket types for the Event.

availability

availability

One of the following: In Stock, Sold Out, Pre-Order

price

price

The lowest available price available for your tickets, including service charges and fees. Don’t forget to update it as prices change or tickets sell out. If the event is available without payment, fees, or service charges, set the price to 0.

currency

priceCurrency

The currency of the price.

valid from

validFrom

The date and time when tickets go on sale (only required on date-restricted offers)

url

url

The URL of a page providing the ability to buy tickets.

images #

images

image

URL of an image or logo for the event or tour. Including an image helps users understand and engage with your event. We recommend that images are 1920px wide (the minimum width is 720px).

reviews #

reviews

review

Detailed reviews and ratings of the item.

name

author

Name of the review author.

published

datePublished

Date of review publication.

description

description

The review description.

rating

reviewRating

Rating of the item and values of the rating system.

rating

aggregateRating

The overall rating of the item, based on a collection of reviews or ratings.
Best and Worst values indicate the range of the rating system.

average

ratingValue

The overall rating value.

count

ratingCount

The total number of ratings for the item on your site.

best

bestRating

The highest value allowed in this rating system. If bestRating is omitted, 5 is assumed.

worst

worstRating

The lowest value allowed in this rating system. If worstRating is omitted, 1 is assumed