Event — Schema.org Type, Hierarchy & Properties

Source: Schema.org v30.1 offline vocabulary. Official Event definition.

What is Event?

An event happening at a certain time and location, such as a concert, lecture, or festival. Ticketing information may be added via the [[offers]] property. Repeated events may be structured as separate Event objects.

Example JSON-LD skeleton

This minimal example only identifies a Schema.org type. It is not a complete entity, a Google rich-result test, or a claim about a real business.

{
  "@context": "https://schema.org",
  "@type": "Event"
}

Full parent hierarchy

Each chain starts at a root type. Multiple paths are shown when Schema.org defines more than one parent. For very complex types, up to 256 paths are displayed; consult the official definition for the full graph.

Thing → Event

Direct parents: Thing

Child types (24)

Properties that accept Event values (13)

Property	On types	Description
broadcastOfEvent	BroadcastEvent	The event being broadcast such as a sporting event or awards ceremony.
event	InformAction or InviteAction or JoinAction or LeaveAction or Organization or Place or PlayAction	Upcoming or past event associated with this place, organization, or action.
events	Organization or Place	Upcoming or past events associated with this place or organization.
firstPerformance	MusicComposition	The date and place the work was first performed.
fundedItem	Grant	Indicates something directly or indirectly funded or sponsored through a [[Grant]]. See also [[ownershipFundingInfo]].
itemOffered	Demand or Offer	An item being offered (or demanded). The transactional nature of the offer or demand is documented using [[businessFunction]], e.g. sell, lease etc. While several common expected types are listed explicitly in this definition, others can be used. Using a second type, such as Product or a subtype of Product, can clarify the nature of the offer.
lifeEvent	Person	A life event like baptism, communions, Bar Mitzvahs, Aqiqah, Namakarana, Miyamairi, burial, ....
performerIn	Person	Event that this person is a performer or participant in.
recordedAt	CreativeWork	The Event where the CreativeWork was recorded. The CreativeWork may capture all or part of the event.
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.
subEvents	Event	Events that are a part of this event. For example, a conference event includes many presentations, each subEvents of the conference.
subjectOf	Thing	A CreativeWork or Event about this Thing.
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.

Properties usable on Event (56)

This list includes properties whose domainIncludes names Event or one of its ancestors. DomainIncludes is advisory; it is not an exhaustive set of permitted properties.

Property	Expected value types	Description
about	Thing	The subject matter of an object.
actor	PerformingGroup, Person	An actor (individual or a group), e.g. in TV, radio, movie, video games etc., or in an event. Actors can be associated with individual items or with a series, episode, clip.
additionalType	Text, URL	An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org <a href="https://schema.org/docs/styleguide.html">style guide</a>.
aggregateRating	AggregateRating	The overall rating, based on a collection of reviews or ratings, of the item.
alternateName	Text	An alias for the item.
attendee	Organization, Person	A person or organization attending the event.
attendees	Organization, Person	A person attending the event.
audience	Audience	An intended audience, i.e. a group for whom something was created.
composer	Organization, Person	The person or organization who wrote a composition, or who is the composer of a work performed at some event.
contributor	Organization, Person	A secondary contributor to the CreativeWork or Event.
description	Text, TextObject	A description of the item.
director	Person	A director of e.g. TV, radio, movie, video gaming etc. content, or of an event. Directors can be associated with individual items or with a series, episode, clip.
disambiguatingDescription	Text	A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
doorTime	DateTime, Time	The time admission will commence.
duration	Duration, QuantitativeValue	The duration of the item (movie, audio recording, event, etc.) in [ISO 8601 duration format](http://en.wikipedia.org/wiki/ISO_8601).
endDate	Date, DateTime	The end date and time of the item (in [ISO 8601 date format](http://en.wikipedia.org/wiki/ISO_8601)).
eventAttendanceMode	EventAttendanceModeEnumeration	The eventAttendanceMode of an event indicates whether it occurs online, offline, or a mix.
eventSchedule	Schedule	Associates an [[Event]] with a [[Schedule]]. There are circumstances where it is preferable to share a schedule for a series of repeating events rather than data on the individual events themselves. For example, a website or application might prefer to publish a schedule for a weekly gym class rather than provide data on every event. A schedule could be processed by applications to add forthcoming events to a calendar. An [[Event]] that is associated with a [[Schedule]] using this property should not have [[startDate]] or [[endDate]] properties. These are instead defined within the associated [[Schedule]], this avoids any ambiguity for clients using the data. The property might have repeated values to specify different schedules, e.g. for different months or seasons.
eventStatus	EventStatusType	An eventStatus of an event represents its status; particularly useful when an event is cancelled or rescheduled.
funder	Organization, Person	A person or organization that supports (sponsors) something through some kind of financial contribution.
funding	Grant	A [[Grant]] that directly or indirectly provide funding or sponsorship for this item. See also [[ownershipFundingInfo]].
hasParticipationOffer	Offer	An offer to participate in the event, for example, Call for Proposals, Call for Speakers, or Call for Performers.
hasSponsorshipOffer	Offer	An offer to sponsor the event, for example, Sponsorship Prospectus, Sponsorship Opportunities, or Sponsor Packages.
identifier	PropertyValue, Text, URL	The identifier property represents any kind of identifier for any kind of [[Thing]], such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See [background notes](/docs/datamodel.html#identifierBg) for more details.
image	ImageObject, URL	An image of the item. This can be a [[URL]] or a fully described [[ImageObject]].
inLanguage	Language, Text	The language of the content or performance or used in an action. Please use one of the language codes from the [IETF BCP 47 standard](http://tools.ietf.org/html/bcp47). See also [[availableLanguage]].
isAccessibleForFree	Boolean	A flag to signal that the item, event, or place is accessible for free.
keywords	DefinedTerm, Text, URL	Keywords or tags used to describe some item. Multiple textual entries in a keywords list are typically delimited by commas, or by repeating the property.
location	Place, PostalAddress, Text, VirtualLocation	The location of, for example, where an event is happening, where an organization is located, or where an action takes place.
mainEntityOfPage	CreativeWork, URL	Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details.
maximumAttendeeCapacity	Integer	The total number of individuals that may attend an event or venue.
maximumPhysicalAttendeeCapacity	Integer	The maximum physical attendee capacity of an [[Event]] whose [[eventAttendanceMode]] is [[OfflineEventAttendanceMode]] (or the offline aspects, in the case of a [[MixedEventAttendanceMode]]).
maximumVirtualAttendeeCapacity	Integer	The maximum virtual attendee capacity of an [[Event]] whose [[eventAttendanceMode]] is [[OnlineEventAttendanceMode]] (or the online aspects, in the case of a [[MixedEventAttendanceMode]]).
name	Text	The name of the item.
offers	Demand, Offer	An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event. Use [[businessFunction]] to indicate the kind of transaction offered, i.e. sell, lease, etc. This property can also be used to describe a [[Demand]]. While this property is listed as expected on a number of common types, it can be used in others. In that case, using a second type, such as Product or a subtype of Product, can clarify the nature of the offer.
organizer	Organization, Person	An organizer of an Event.
owner	Organization, Person	A person or organization who owns this Thing.
performer	Organization, Person	A performer at the event—for example, a presenter, musician, musical group or actor.
performers	Organization, Person	The main performer or performers of the event—for example, a presenter, musician, or actor.
potentialAction	Action	Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
previousStartDate	Date, DateTime	Used in conjunction with eventStatus for rescheduled or cancelled events. This property contains the previously scheduled start date. For rescheduled events, the startDate property should be used for the newly scheduled start date. In the (rare) case of an event that has been postponed and rescheduled multiple times, this field may be repeated.
recordedIn	CreativeWork	The CreativeWork that captured all or part of this Event.
remainingAttendeeCapacity	Integer	The number of attendee places for an event that remain unallocated.
review	Review	A review of the item.
sameAs	URL	URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.
sponsor	Organization, Person	A person or organization that supports a thing through a pledge, promise, or financial contribution. E.g. a sponsor of a Medical Study or a corporate sponsor of an event.
startDate	Date, DateTime	The start date and time of the item (in [ISO 8601 date format](http://en.wikipedia.org/wiki/ISO_8601)).
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.
subEvents	Event	Events that are a part of this event. For example, a conference event includes many presentations, each subEvents of the conference.
subjectOf	CreativeWork, Event	A CreativeWork or Event about this Thing.
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.
translator	Organization, Person	Organization or person who adapts a creative work to different languages, regional differences and technical requirements of a target market, or that translates during some event.
typicalAgeRange	Text	The typical expected age range, e.g. '7-9', '11-'.
url	URL	URL of the item.
workFeatured	CreativeWork	A work featured in some event, e.g. exhibited in an ExhibitionEvent. Specific subproperties are available for workPerformed (e.g. a play), or a workPresented (a Movie at a ScreeningEvent).
workPerformed	CreativeWork	A work performed in some event, for example a play performed in a TheaterEvent.

Practical use of Event

Event describes something happening at a particular time, such as a concert, workshop or online session. It is not a substitute for a generic article about events. Dates, time zones and the attendance mode should match the event listing.

Practical scenario

An online workshop and an in-person concert are both events, but the location and attendance details are not interchangeable. First verify the real event title and whether the page is advertising an upcoming event or describing a past one. If a schedule includes a time of day, confirm its timezone and any changes to the start time. A virtual event should not receive a made-up venue address, while a physical event should not borrow the organizer’s office address unless that is the actual venue. Offers, ticket prices and availability should only be included when the event organizer provides verified terms. A cancelled or rescheduled event also needs careful editorial updates. Schema.org can describe the event, but it cannot confirm the schedule or promise any particular search display.

Common mistakes to avoid

Confirm that the event exists and has a genuine schedule.
Check the start time, end time and timezone rather than guessing them.
Distinguish a virtual event from a physical venue; do not invent a street address.

Illustrative JSON-LD example

Example only: every placeholder must be replaced with verified, page-visible facts. This is not a complete Google rich-result implementation.

{
  "@context": "https://schema.org",
  "@type": "Event",
  "name": "Example event — placeholder",
  "description": "Illustrative event only; supply actual schedule separately"
}

Reference: Schema.org Event. For Google-specific eligibility, consult the official Search Gallery; Schema.org membership alone does not establish eligibility.

Schema.org vs Google

This type's presence in Schema.org is not a Google feature approval. Check our dated Google status snapshot and Google's official Rich Results Test separately.

← Back to Schema Explorer