Thing > CreativeWork > Movie

A movie.
PropertyExpected TypeDescription
Properties from Movie
actor Person A cast member of the movie, tv/radio series, season, episode, or video. Supercedes actors.
director Person The director of the movie, tv/radio episode or series. Supercedes directors.
duration Duration The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
musicBy MusicGroup 
or Person 
The composer of the movie or TV/radio soundtrack.
producer Person The producer of the movie, tv/radio series, season, or episode, or video.
productionCompany Organization The production company or studio that made the movie, tv/radio series, season, or episode, or media object.
trailer VideoObject The trailer of a movie or tv/radio series, season, or episode.
Properties from CreativeWork
about Thing The subject matter of the content.
accessibilityAPI Text Indicates that the resource is compatible with the referenced accessibility API (WebSchemas wiki lists possible values).
accessibilityControl Text Identifies input methods that are sufficient to fully control the described resource (WebSchemas wiki lists possible values).
accessibilityFeature Text Content features of the resource, such as accessible media, alternatives and supported enhancements for accessibility (WebSchemas wiki lists possible values).
accessibilityHazard Text A characteristic of the described resource that is physiologically dangerous to some users. Related to WCAG 2.0 guideline 2.3. (WebSchemas wiki lists possible values)
accountablePerson Person Specifies the Person that is legally accountable for the CreativeWork.
aggregateRating AggregateRating The overall rating, based on a collection of reviews or ratings, of the item.
alternativeHeadline Text A secondary title of the CreativeWork.
associatedMedia MediaObject The media objects that encode this creative work. This property is a synonym for encodings.
audience Audience The intended audience of the item, i.e. the group for whom the item was created.
audio AudioObject An embedded audio object.
author Person 
or Organization 
The author of this content. Please note that author is special in that HTML 5 provides a special mechanism for indicating authorship via the rel tag. That is equivalent to this and may be used interchangeably.
award Text An award won by this person or for this creative work. Supercedes awards.
citation CreativeWork 
or Text 
A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.
comment UserComments 
or Comment 
Comments, typically from users, on this CreativeWork.
commentCount Integer The number of comments this CreativeWork (e.g. Article, Question or Answer) has received. This is most applicable to works published in Web sites with commenting system; additional comments may exist elsewhere.
contentLocation Place The location of the content.
contentRating Text Official rating of a piece of content—for example,'MPAA PG-13'.
contributor Person 
or Organization 
A secondary contributor to the CreativeWork.
copyrightHolder Person 
or Organization 
The party holding the legal copyright to the CreativeWork.
copyrightYear Number The year during which the claimed copyright for the CreativeWork was first asserted.
creator Person 
or Organization 
The creator/author of this CreativeWork or UserComments. This is the same as the Author property for CreativeWork.
dateCreated Date The date on which the CreativeWork was created.
dateModified Date The date on which the CreativeWork was most recently modified.
datePublished Date Date of first broadcast/publication.
discussionUrl URL A link to the page containing the comments of the CreativeWork.
editor Person Specifies the Person who edited the CreativeWork.
educationalAlignment AlignmentObject An alignment to an established educational framework.
educationalUse Text The purpose of a work in the context of education; for example, 'assignment', 'group work'.
encoding MediaObject A media object that encode this CreativeWork. Supercedes encodings.
genre Text Genre of the creative work
headline Text Headline of the article
inLanguage Text The language of the content. please use one of the language codes from the IETF BCP 47 standard.
interactionCount Text A count of a specific user interactions with this item—for example, 20 UserLikes, 5 UserComments, or 300 UserDownloads. The user interaction type should be one of the sub types of UserInteraction.
interactivityType Text The predominant mode of learning supported by the learning resource. Acceptable values are 'active', 'expositive', or 'mixed'.
isBasedOnUrl URL A resource that was used in the creation of this resource. This term can be repeated for multiple sources. For example, http://example.com/great-multiplication-intro.html
isFamilyFriendly Boolean Indicates whether this content is family friendly.
keywords Text The keywords/tags used to describe this content.
learningResourceType Text The predominant type or kind characterizing the learning resource. For example, 'presentation', 'handout'.
mentions Thing Indicates that the CreativeWork contains a reference to, but is not necessarily about a concept.
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.
provider Person 
or Organization 
The organization or agency that is providing the service.
publisher Organization The publisher of the creative work.
publishingPrinciples URL Link to page describing the editorial principles of the organization primarily responsible for the creation of the CreativeWork.
review Review A review of the item. Supercedes reviews.
sourceOrganization Organization The Organization on whose behalf the creator was working.
text Text The textual content of this CreativeWork.
thumbnailUrl URL A thumbnail image relevant to the Thing.
timeRequired Duration Approximate or typical time it takes to work with or through this learning resource for the typical intended target audience, e.g. 'P30M', 'P1H25M'.
typicalAgeRange Text The typical expected age range, e.g. '7-9', '11-'.
version Number The version of the CreativeWork embodied by a specified resource.
video VideoObject An embedded video object.
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.
alternateName Text An alias for the item.
description Text A short description of the item.
image URL URL of an image of the item.
name Text The name of the item.
potentialAction Action Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
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, Freebase page, or official website.
url URL URL of the item.


Examples

 
<h1>Pirates of the Carribean: On Stranger Tides (2011)</h1>
Jack Sparrow and Barbossa embark on a quest to find the elusive fountain
 of youth, only to discover that Blackbeard and his daughter are after it too.
Director: Rob Marshall
Writers: Ted Elliott, Terry Rossio, and 7 more credits
Stars: Johnny Depp, Penelope Cruz, Ian McShane
8/10 stars from 200 users. Reviews: 50. 
 
<div itemscope itemtype="http://schema.org/Movie">
<h1 itemprop="name">Pirates of the Carribean: On Stranger Tides (2011)</h1>
<span itemprop="description">Jack Sparrow and Barbossa embark on a quest to
 find the elusive fountain of youth, only to discover that Blackbeard and
 his daughter are after it too.</span>
Director:
 <div itemprop="director" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">Rob Marshall</span>
</div>
Writers:
 <div itemprop="author" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">Ted Elliott</span>
</div>
<div itemprop="author" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">Terry Rossio</span>
</div>
, and 7 more credits
Stars:
 <div itemprop="actor" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">Johnny Depp</span>,
 </div>
<div itemprop="actor" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">Penelope Cruz</span>,
</div>
<div itemprop="actor" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">Ian McShane</span>
</div>
<div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
  <span itemprop="ratingValue">8</span>/<span itemprop="bestRating">10</span> stars from
  <span itemprop="ratingCount">200</span> users.
  Reviews: <span itemprop="reviewCount">50</span>.
</div>
</div> 
 
<div vocab="http://schema.org/" typeof="Movie">
<h1 property="name">Pirates of the Carribean: On Stranger Tides (2011)</h1>
<span property="description">Jack Sparrow and Barbossa embark on a quest to
 find the elusive fountain of youth, only to discover that Blackbeard and
 his daughter are after it too.</span>
Director:
 <div property="director"  typeof="Person">
<span property="name">Rob Marshall</span>
</div>
Writers:
 <div property="author"  typeof="Person">
<span property="name">Ted Elliott</span>
</div>
<div property="author"  typeof="Person">
<span property="name">Terry Rossio</span>
</div>
, and 7 more credits
Stars:
 <div property="actor"  typeof="Person">
<span property="name">Johnny Depp</span>,
 </div>
<div property="actor"  typeof="Person">
<span property="name">Penelope Cruz</span>,
</div>
<div property="actor"  typeof="Person">
<span property="name">Ian McShane</span>
</div>
<div property="aggregateRating"  typeof="AggregateRating">
  <span property="ratingValue">8</span>/<span property="bestRating">10</span> stars from
  <span property="ratingCount">200</span> users.
  Reviews: <span property="reviewCount">50</span>.
</div>
</div> 
<script type="application/ld+json">
{
  "@context": "http://schema.org", 
  "@type": "Movie", 
  "actor": [
    {
      "@type": "Person", 
      "name": "Johnny Depp"
    }, 
    {
      "@type": "Person", 
      "name": "Penelope Cruz"
    }, 
    {
      "@type": "Person", 
      "name": "Ian McShane"
    }
  ], 
  "aggregateRating": {
    "@type": "AggregateRating", 
    "bestRating": "10", 
    "ratingCount": "200", 
    "ratingValue": "8", 
    "reviewCount": "50"
  }, 
  "author": [
    {
      "@type": "Person", 
      "name": "Ted Elliott"
    }, 
    {
      "@type": "Person", 
      "name": "Terry Rossio"
    }
  ], 
  "description": "Jack Sparrow and Barbossa embark on a quest to find the elusive fountain of youth, only to discover that Blackbeard and his daughter are after it too.", 
  "director": {
    "@type": "Person", 
    "name": "Rob Marshall"
  }, 
  "name": "Pirates of the Carribean: On Stranger Tides (2011)"
}
</script> 
A Movie named "Footloose" with a WatchAction as a
potentialAction, with a target of http://example.com/player?id=123.
This example is JSON only.
This example is JSON only.
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Movie",
  "name": "Footloose",
  "potentialAction" : {
    "@type": "WatchAction",
    "target" : "http://example.com/player?id=123"
  }
}
</script>

Schema Version 1.2