Thing > Event

An event happening at a certain time at a certain location.
PropertyExpected TypeDescription
Properties from Thing
additionalType 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. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.
description Text A short description of the item.
image URL URL of an image of the item.
name Text The name of the item.
url URL URL of the item.
Properties from Event
attendee Organization or Person A person or organization attending the event.
attendees Organization or Person A person attending the event (legacy spelling; see singular form, attendee).
duration Duration The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
endDate Date The end date and time of the event (in ISO 8601 date format).
location Place or PostalAddress The location of the event or organization.
offers Offer An offer to sell this item—for example, an offer to sell a product, the DVD of a movie, or tickets to an event.
performer Organization or Person A performer at the event—for example, a presenter, musician, musical group or actor.
performers Organization or Person The main performer or performers of the event—for example, a presenter, musician, or actor (legacy spelling; see singular form, performer).
startDate Date The start date and time of the event (in ISO 8601 date format).
subEvent Event An Event that is part of this event. For example, a conference event includes many presentations, each are a subEvent of the conference.
subEvents Event Events that are a part of this event. For example, a conference event includes many presentations, each are subEvents of the conference (legacy spelling; see singular form, subEvent).
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.

More specific types

Schema Draft Version 1.0a
Example 1

Original HTML: 

<a href="nba-miami-philidelphia-game3.html">
NBA Eastern Conference First Round Playoff Tickets:
 Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1)
</a>

Thu, 04/21/16
8:00 p.m.

<a href="wells-fargo-center.html">
Wells Fargo Center
</a>
Philadelphia, PA

Priced from: $35
1938 tickets left


With Microdata: 
<div itemscope itemtype="http://schema.org/Event">
  <a itemprop="url" href="nba-miami-philidelphia-game3.html">
  NBA Eastern Conference First Round Playoff Tickets:
  <span itemprop="name"> Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1) </span>
  </a>

  <meta itemprop="startDate" content="2016-04-21T20:00">
    Thu, 04/21/16
    8:00 p.m.

  <div itemprop="location" itemscope itemtype="http://schema.org/Place">
    <a itemprop="url" href="wells-fargo-center.html">
    Wells Fargo Center
    </a>
    <div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
      <span itemprop="addressLocality">Philadelphia</span>,
      <span itemprop="addressRegion">PA</span>
    </div>
  </div>

  <div itemprop="offers" itemscope itemtype="http://schema.org/AggregateOffer">
    Priced from: <span itemprop="lowPrice">$35</span>
    <span itemprop="offerCount">1938</span> tickets left
  </div>
</div>
Example 2

Original HTML: 

<h1>Foo Fighters</h1>


<h2>Video: Interview with the Foo Fighters</h2>
<object ...>
  <param ...>
  <embed type="application/x-shockwave-flash" ...>
</object>
Catch this exclusive interview with Dave Grohl and the Food Fighters
 about their new album, Rope.


<h2>Songs</h2>

Rope
 Length: 4:05 - 14300 plays
<a href="foo-fighters-rope-play.html">Play</a>
<a href="foo-fighters-rope-buy.html">Buy</a>
From album: <a href="foo-fighters-wasting-light.html">Wasting Light</a>

Everlong
 Length: 6:33 - 11700 plays
<a href="foo-fighters-everlong-play.html">Play</a>
<a href="foo-fighters-everlong-buy.html">Buy</a>
From album: <a href="foo-fighters-color-and-shape.html">The Color And The Shape</a>


<h2>Upcoming shows</h2>

<a href="foo-fighters-may20-fedexforum">FedExForum</a>
Memphis, TN, US
May 20
<a href="ticketworlds.com/foofighters/may20-2011">Buy tickets</a>

<a href="foo-fighters-may23-midamericacenter">Mid America Center</a>
Council Bluffs, IA, US
May 23
<a href="ticketworlds.com/foofighters/may23-2011">Buy tickets</a>


<h2><a href="foo-fighters-photos">28 Photos</a></h2>
<a href="foofighters-1.jpg"><img src="foofighters-thumb1.jpg" /></a>
<a href="foofighters-2.jpg"><img src="foofighters-thumb2.jpg" /></a>
<a href="foofighters-3.jpg"><img src="foofighters-thumb3.jpg" /></a>


<h2>Comments:</h2>
Excited about seeing them in concert next week. -Lawrence , Jan 23
I dig their latest single. -Mary, Jan 19
Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>


With Microdata: 
<div itemscope itemtype="http://schema.org/MusicGroup">

<h1 itemprop="name">Foo Fighters</h1>


<div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
  <h2>Video: <span itemprop="name">Interview with the Foo Fighters</span></h2>
  <meta itemprop="duration" content="T1M33S" />
  <meta itemprop="thumbnail" content="foo-fighters-interview-thumb.jpg" />
  <object ...>
    <param ...>
    <embed type="application/x-shockwave-flash" ...>
  </object>
  <span itemprop="description">Catch this exclusive interview with
    Dave Grohl and the Food Fighters about their new album, Rope.</span>
</div>


<h2>Songs</h2>

<div itemprop="track" itemscope itemtype="http://schema.org/MusicRecording">
  <span itemprop="name">Rope</span>
  <meta itemprop="url" content ="foo-fighters-rope.html">
  Length: <meta itemprop="duration" content="PT4M5S">4:05 -
  14300 plays<meta itemprop="interactionCount" content="UserPlays:14300" />
  <a href="foo-fighters-rope-play.html" itemprop="audio">Play</a>
  <a href="foo-fighters-rope-buy.html" itemprop="offers">Buy</a>
  From album: <a href="foo-fighters-wasting-light.html"
    itemprop="inAlbum">Wasting Light</a>
</div>

<div itemprop="track" itemscope itemtype="http://schema.org/MusicRecording">
  <span itemprop="name">Everlong</span>
  <meta itemprop="url" content ="foo-fighters-everlong.html">
  Length: <meta itemprop="duration" content="PT6M33S">6:33 -
  <span itemprop="playCount">11700</span> plays
  <a href="foo-fighters-everlong-play.html" itemprop="audio">Play</a>
  <a href="foo-fighters-everlong-buy.html" itemprop="offers">Buy</a>
  From album: <a href="foo-fighters-color-and-shape.html"
    itemprop="inAlbum">The Color And The Shape</a>
</div>


<h2>Upcoming shows</h2>

<div itemprop="event" itemscope itemtype="http://schema.org/Event">
  <a href="foo-fighters-may20-fedexforum" itemprop="url">
    <span itemprop="name">FedExForum</span>
  </a>
  <span itemprop="location">Memphis, TN, US</span>
  <meta itemprop="startDate" content="2011-05-20">May 20
  <a href="ticketmaster.com/foofighters/may20-2011" itemprop="offers">Buy tickets</a>
</div>

<div itemprop="event" itemscope itemtype="http://schema.org/Event">
  <a href="foo-fighters-may23-midamericacenter" itemprop="url">
    <span itemprop="name">Mid America Center</span>
  </a>
  <span itemprop="location">Council Bluffs, IA, US</span>
  <meta itemprop="startDate" content="2011-05-23">May 23
  <a href="ticketmaster.com/foofighters/may23-2011" itemprop="offers">Buy tickets</a>
</div>

<h2><a href="foo-fighters-photos">28 Photos</a></h2>
<a href="foofighters-1.jpg" itemprop="image"><img src="foofighters-thumb1.jpg" /></a>
<a href="foofighters-2.jpg" itemprop="image"><img src="foofighters-thumb2.jpg" /></a>
<a href="foofighters-3.jpg" itemprop="image"><img src="foofighters-thumb3.jpg" /></a>


<h2>Comments:</h2>
Excited about seeing them in concert next week. -Lawrence , Jan 23
I dig their latest single. -Mary, Jan 19
<meta itemprop="interactionCount" content="UserComments:18" />
Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>

</div>