ImageObject

An image file.

Property	Expected Type	Description
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.
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 CreativeWork 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`	QuantitativeValue or Distance	The height of the item.
`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.
`offers`	Offer	An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, or give away tickets to an event.
`playerType`	Text	Player type required—for example, Flash or Silverlight.
`productionCompany`	Organization	The production company or studio that made the movie, tv/radio series, season, or episode, or media object.
`publication`	PublicationEvent	A publication event associated with the episode, clip or media object.
`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`	QuantitativeValue or Distance	The width of the item.
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	A media object that encodes this CreativeWork. This property is a synonym for encoding.
`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. Supersedes awards.
`citation`	CreativeWork or Text	A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.
`comment`	Comment or UserComments	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 encodes this CreativeWork. This property is a synonym for associatedMedia. Supersedes encodings.
`exampleOfWork`	CreativeWork	A creative work that this work is an example/instance/realization/derivation of. Inverse property: workExample.
`genre`	Text	Genre of the creative work
`hasPart`	CreativeWork	Indicates a CreativeWork that is (in some sense) a part of this CreativeWork. Inverse property: isPartOf.
`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.
`isPartOf`	CreativeWork	Indicates a CreativeWork that this CreativeWork is (in some sense) part of. Inverse property: hasPart.
`keywords`	Text	Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas.
`learningResourceType`	Text	The predominant type or kind characterizing the learning resource. For example, 'presentation', 'handout'.
`license`	CreativeWork or URL	A license document that applies to this content, typically indicated by URL.
`mentions`	Thing	Indicates that the CreativeWork contains a reference to, but is not necessarily about a concept.
`offers`	Offer	An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, or give away tickets to an event.
`position`	Integer or Text	The position of the creative work within a series or other ordered collection of works.
`provider`	Person or Organization	The service provider, service operator, or service performer; the goods producer. Another party (a seller) may offer those services or goods on behalf of the provider. A provider may also serve as the seller. Supersedes carrier.
`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. Supersedes 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.
`workExample`	CreativeWork	Example/instance/realization/derivation of the concept of this creative work. eg. The paperback edition, first edition, or eBook. Inverse property: exampleOfWork.
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 or ImageObject	An image of the item. This can be a URL or a fully described ImageObject.
`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.

Instances of ImageObject may appear as values for the following properties

Property	On Types	Description
`diagram`	AnatomicalStructure	An image containing a diagram that illustrates the structure and/or its component substructures and/or connections with other structures.
`image`	Thing	An image of the item. This can be a URL or a fully described ImageObject.
`logo`	Product or Organization or Place or Brand	A logo associated with an organization.
`photo`	Place	A photograph of this place. Supersedes photos.
`primaryImageOfPage`	WebPage	Indicates the main image on the page.
`screenshot`	SoftwareApplication	A link to a screenshot image of the app.
`thumbnail`	VideoObject or ImageObject	Thumbnail image for an image or video.

Examples

Without Markup Microdata RDFa JSON-LD

<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.

<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>

<div vocab="http://schema.org/" typeof="ImageObject">
  <h2 property="name">Beach in Mexico</h2>
  <img src="mexico-beach.jpg" property="contentUrl" />
  By <span property="author">Jane Doe</span>
  Photographed in
    <span property="contentLocation">Puerto Vallarta, Mexico</span>
  Date uploaded:
    <meta property="datePublished" content="2008-01-25">Jan 25, 2008
  <span property="description">I took this picture while on vacation last year.</span>
</div>

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "ImageObject",
  "author": "Jane Doe",
  "contentLocation": "Puerto Vallarta, Mexico",
  "contentUrl": "mexico-beach.jpg",
  "datePublished": "2008-01-25",
  "description": "I took this picture while on vacation last year.",
  "name": "Beach in Mexico"
}
</script>

Schema Version 1.91