ImageObject

Thing > CreativeWork > MediaObject > ImageObject

An image file.

Usage: Over 1,000,000 domains

[more...]

Leave public feedback on this term 💬
Check for open issues.
'ImageObject' is mentioned in layer: core

Property	Expected Type	Description
Properties from ImageObject
`caption`	Text	The caption for this object.
`exifData`	PropertyValue or 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.
`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.
`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.
`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
`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.
`audience`	Audience	An intended audience, i.e. a group for whom something was created. Supersedes serviceAudience.
`award`	Text	An award won by or for this item. Supersedes awards.
`citation`	CreativeWork or Text	A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.
`contributor`	Organization or Person	A secondary contributor to the CreativeWork or Event.
`creator`	Organization or Person	The creator/author of this CreativeWork. This is the same as the Author property for CreativeWork.
`editor`	Person	Specifies the Person who edited the CreativeWork.
`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.
`fileFormat`	Text or URL	Media type, typically MIME format (see IANA site) of the content e.g. application/zip of a SoftwareApplication binary. In cases where a CreativeWork has several media type representations, 'encoding' can be used to indicate each MediaObject alongside particular fileFormat information. Unregistered or niche file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia entry.
`genre`	Text or URL	Genre of the creative work or group.
`hasPart`	CreativeWork	Indicates a CreativeWork that is (in some sense) a part of this CreativeWork. Inverse property: isPartOf.
`isBasedOn`	CreativeWork or Product or 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. Supersedes isBasedOnUrl.
`isPartOf`	CreativeWork	Indicates a CreativeWork that this CreativeWork is (in some sense) part of. Inverse property: hasPart.
`license`	CreativeWork or URL	A license document that applies to this content, typically indicated by URL.
`mainEntity`	Thing	Indicates the primary entity described in some page or other CreativeWork. Inverse property: mainEntityOfPage.
`provider`	Organization or Person	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.
`publication`	PublicationEvent	A publication event associated with the item.
`publishingPrinciples`	URL	Link to page describing the editorial principles of the organization primarily responsible for the creation of the CreativeWork.
`recordedAt`	Event	The Event where the CreativeWork was recorded. The CreativeWork may capture all or part of the event. Inverse property: recordedIn.
`sourceOrganization`	Organization	The Organization on whose behalf the creator was working.
`sponsor`	Organization or Person	A person or organization that supports a thing through a pledge, promise, or financial contribution. e.g. a sponsor of a Medical Study or a corporate sponsor of an event.
`temporalCoverage`	DateTime or Text or URL	The temporalCoverage of a CreativeWork indicates the period that the content applies to, i.e. that it describes, either as a DateTime or as a textual string indicating a time period in ISO 8601 time interval format. In the case of a Dataset it will typically indicate the relevant time period in a precise notation (e.g. for a 2011 census dataset, the year 2011 would be written "2011/2012"). Other forms of content e.g. ScholarlyArticle, Book, TVSeries or TVEpisode may indicate their temporalCoverage in broader terms - textually or via well-known URL. Written works such as books may sometimes have precise temporal coverage too, e.g. a work set in 1939 - 1945 can be indicated in ISO 8601 interval format format via "1939/1945". Supersedes datasetTimeInterval, temporal.
`translator`	Organization or Person	Organization or person who adapts a creative work to different languages, regional differences and technical requirements of a target market, or that translates during some event.
`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 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.
`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, 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`	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

For CreativeWork in the bib extension: publisherImprint, translationOfWork, workTranslation
For CreativeWork in the pending extension: accessMode, accessModeSufficient, accessibilitySummary, contentReferenceTime

More specific Types

Barcode

Examples

Example 1

Without Markup Microdata RDFa JSON-LD

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

Example 2

Without Markup Microdata RDFa JSON-LD

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

Schema Version 3.1