Thing > CreativeWork > MediaObject > ImageObject

An image file.
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 CreativeWork
about Thing The subject matter of the content.
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 work, i.e. the group for whom the work was created.
audio AudioObject An embedded audio object.
author Organization or Person 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.
awards Text Awards won by this person or for this creative work. (legacy spelling; see singular form, award)
comment UserComments Comments, typically from users, on this CreativeWork.
contentLocation Place The location of the content.
contentRating Text Official rating of a piece of content—for example,'MPAA PG-13'.
contributor Organization or Person A secondary contributor to the CreativeWork.
copyrightHolder Organization or Person 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 Organization or Person 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.
encoding MediaObject A media object that encode this CreativeWork.
encodings MediaObject The media objects that encode this creative work (legacy spelling; see singular form, encoding).
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.
isFamilyFriendly Boolean Indicates whether this content is family friendly.
keywords Text The keywords/tags used to describe this content.
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 Organization or Person Specifies the Person or Organization that distributed the CreativeWork.
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.
reviews Review Review of the item (legacy spelling; see singular form, review).
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.
version Number The version of the CreativeWork embodied by a specified resource.
video VideoObject An embedded video object.
Properties from MediaObject
associatedArticle NewsArticle A NewsArticle associated with the Media Object.
bitrate Text The bitrate of the media object.
contentSize Text File size in (mega/kilo) bytes.
contentUrl URL Actual bytes of the media object, for example the image file or video file. (previous spelling: contentURL)
duration Duration The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
embedUrl URL A URL pointing to a player for a specific video. In general, this is the information in the src element of an embed tag and should not be the same as the content of the loc tag. (previous spelling: embedURL)
encodesCreativeWork CreativeWork The creative work encoded by this media object
encodingFormat Text mp3, mpeg4, etc.
expires Date Date the content expires and is no longer useful or available. Useful for videos.
height Distance or QuantitativeValue The height of the item.
playerType Text Player type required—for example, Flash or Silverlight.
regionsAllowed Place The regions where the media is allowed. If not specified, then it's assumed to be allowed everywhere. Specify the countries in ISO 3166 format.
requiresSubscription Boolean Indicates if use of the media require a subscription (either paid or free). Allowed values are true or false (note that an earlier version had 'yes', 'no').
uploadDate Date Date when this media object was uploaded to this site.
width Distance or QuantitativeValue The width of the item.
Properties from ImageObject
caption Text The caption for this object.
exifData Text exif data for this object.
representativeOfPage Boolean Indicates whether this image is representative of the content of the page.
thumbnail ImageObject Thumbnail image for an image or video.
Schema Draft Version 0.99

Example 1

Original HTML:

<h2>Beach in Mexico</h2>
<img src="mexico-beach.jpg" />

By Jane Doe
Photographed in Puerto Vallarta, Mexico
Date uploaded: Jan 25, 2008

I took this picture while on vacation last year.


With Microdata:
<div itemscope itemtype="http://schema.org/ImageObject">
  <h2 itemprop="name">Beach in Mexico</h2>
  <img src="mexico-beach.jpg" itemprop="contentURL" />

  By <span itemprop="author">Jane Doe</span>
  Photographed in
    <span itemprop="contentLocation">Puerto Vallarta, Mexico</span>
  Date uploaded:
    <meta itemprop="datePublished" content="2008-01-25">Jan 25, 2008

  <span itemprop="description">I took this picture while on vacation last year.</span>
</div>