core + pending (Pending Extension): these terms are pending wider review. Feedback is welcomed!

ImageObject

Canonical URL: http://schema.org/ImageObject

Thing > CreativeWork > MediaObject > ImageObject

An image file.

Usage: Over 1,000,000 domains
PropertyExpected TypeDescription
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.
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.
encodesCreativeWork CreativeWork The CreativeWork encoded by this media object.
encodingFormat Text mp3, mpeg4, etc.
height Distance  or
QuantitativeValue 
The height of the item.
playerType Text Player type required—for example, Flash or Silverlight.
productionCompany Organization The production company or studio responsible for the item e.g. series, video game, episode etc.
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 CreativeWork
accessibilityControl Text Identifies input methods that are sufficient to fully control the described resource (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).
associatedMedia MediaObject A media object that encodes this CreativeWork. This property is a synonym for encoding.
comment Comment Comments, typically from users.
contentLocation Place The location depicted or described in the content. For example, the location in a photograph or painting.
encoding MediaObject A media object that encodes this CreativeWork. This property is a synonym for associatedMedia. Supersedes encodings.
hasPart CreativeWork Indicates a CreativeWork that is (in some sense) a part of this CreativeWork.
Inverse property: isPartOf.
inLanguage Language  or
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. See also availableLanguage. Supersedes language.
interactionStatistic InteractionCounter The number of interactions for the CreativeWork using the WebSite or SoftwareApplication. The most specific child type of InteractionCounter should be used. Supersedes interactionCount.
isPartOf CreativeWork Indicates a CreativeWork that this CreativeWork is (in some sense) part of.
Inverse property: hasPart.
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.
position Integer  or
Text 
The position of an item in a series or sequence of items.
recordedAt Event The Event where the CreativeWork was recorded. The CreativeWork may capture all or part of the event.
Inverse property: recordedIn.
review Review A review of the item. Supersedes reviews.
thumbnailUrl URL A thumbnail image relevant to the Thing.
version Number  or
Text 
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 description of the item.
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.
identifier PropertyValue  or
Text  or
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 for more details.
image ImageObject  or
URL 
An image of the item. This can be a URL or a fully described ImageObject.
mainEntityOfPage CreativeWork  or
URL 
Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
Inverse property: mainEntity.
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, Wikidata entry, or official website.
subjectOf CreativeWork  or
Event 
A CreativeWork or Event about this Thing..
Inverse property: about.
url URL URL of the item.


Instances of ImageObject may appear as values for the following properties

PropertyOn TypesDescription
image Thing An image of the item. This can be a URL or a fully described ImageObject.
logo Brand  or
Organization  or
Place  or
Product  or
Service 
An associated logo.
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 ImageObject  or
VideoObject 
Thumbnail image for an image or video.

Available properties in extensions


More specific Types

Examples

Example 1
<h2>Beach in Mexico</h2>
<img src="mexico-beach.jpg" alt="Sunny, sandy beach."/>
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"
  alt="Sunny, sandy beach."
  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" alt="Sunny, sandy beach."
  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>
Example 2
<h2>Beach in Mexico</h2>
<img src="mexico-beach.jpg" alt="" />
By Jane Doe
Photographed in Puerto Vallarta, Mexico
Date uploaded: Jan 25, 2008
I took this picture while on vacation last year.
<!-- We assume the following EXIF meta-data is available, but currently not shown:
Exposure Time:    1/659 sec.
FNumber:          f/4.0
MaxApertureValue: 2.00
Metering Mode:    Pattern
Flash:            Flash did not fire.
-->
<div itemscope itemtype="http://schema.org/ImageObject">
  <h2 itemprop="name">Beach in Mexico</h2>
  <img src="mexico-beach.jpg" alt="" 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>
<!-- Note: We do not split value strings in unit and value information, since this the raw EXIF data does not provide this granularity. If you are able to separate the unit, you can use the unitText property -->
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="Exposure Time">
      <meta itemprop="value" content="1/659 sec.">
  </div>
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="FNumber">
      <meta itemprop="value" content="f/4.0">
  </div>
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="MaxApertureValue">
      <meta itemprop="value" content="2.00">
  </div>
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="Metering Mode">
      <meta itemprop="value" content="Pattern">
  </div>
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="Flash">
      <meta itemprop="value" content="Flash did not fire.">
  </div>
</div>
<div vocab="http://schema.org/" typeof="ImageObject">
  <h2 property="name">Beach in Mexico</h2>
  <img src="mexico-beach.jpg" alt="" 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>
<!-- Note: We do not split value strings in unit and value information, since this the raw EXIF data does not provide this granularity. If you are able to separate the unit, you can use the unitText property -->
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="Exposure Time">
      <meta property="value" content="1/659 sec.">
  </div>
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="FNumber">
      <meta property="value" content="f/4.0">
  </div>
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="MaxApertureValue">
      <meta property="value" content="2.00">
  </div>
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="Metering Mode">
      <meta property="value" content="Pattern">
  </div>
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="Flash">
      <meta property="value" content="Flash did not fire.">
  </div>
</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",
  "exifData": [
    {
      "@type": "PropertyValue",
      "name": "Exposure Time",
      "value": "1/659 sec."
    },
    {
     "@type": "PropertyValue",
      "name": "FNumber",
      "value": "f/4.0"
    },
    {
      "@type": "PropertyValue",
      "name": "MaxApertureValue",
      "value": "2.00"
    },
    {
      "@type": "PropertyValue",
      "name": "Metering Mode",
      "value": "Pattern"
    },
    {
      "@type": "PropertyValue",
      "name": "Flash",
      "value": "Flash did not fire."
    }
  ]
}
</script>

Schema Version 3.3