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
`about`	Thing	The subject matter of the content.
`accessibilityControl`	Text	Identifies input methods that are sufficient to fully control the described resource (WebSchemas wiki lists possible values).
`aggregateRating`	AggregateRating	The overall rating, based on a collection of reviews or ratings, of the item.
`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.
`author`	Organization or Person	The author of this content or rating. 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 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.
`copyrightHolder`	Organization or Person	The party holding the legal copyright to the CreativeWork.
`educationalAlignment`	AlignmentObject	An alignment to an established educational framework.
`encoding`	MediaObject	A media object that encodes this CreativeWork. This property is a synonym for associatedMedia. Supersedes encodings.
`funder`	Organization or Person	A person or organization that supports (sponsors) something through some kind of financial contribution.
`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.
`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.
`mainEntity`	Thing	Indicates the primary entity described in some page or other CreativeWork. Inverse property: mainEntityOfPage.
`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, perform a service, or give away tickets to an event.
`producer`	Organization or Person	The person or organization who produced the work (e.g. music album, movie, tv/radio series etc.).
`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.
`publisher`	Organization or Person	The publisher of the creative work.
`releasedEvent`	PublicationEvent	The place and time the release was issued, expressed as a PublicationEvent.
`review`	Review	A review of the item. Supersedes reviews.
`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.
`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.
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

More specific Types

Barcode

Examples

Example 1

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>

Example 2

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>

Schema Version 3.1