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.
`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	An intended audience, i.e. a group for whom something was created. Supersedes serviceAudience.
`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 or for this item. Supersedes awards.
`character`	Person	Fictional person connected with a creative work.
`citation`	CreativeWork or Text	A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.
`comment`	Comment	Comments, typically from users.
`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 depicted or described in the content. For example, the location in a photograph or painting.
`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. This is the same as the Author property for CreativeWork.
`dateCreated`	DateTime or Date	The date on which the CreativeWork was created or the item was added to a DataFeed.
`dateModified`	DateTime or Date	The date on which the CreativeWork was most recently modified or when the item's entry was modified within a DataFeed.
`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.
`fileFormat`	Text	Media type (aka 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.
`genre`	URL or Text	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.
`headline`	Text	Headline of the article.
`inLanguage`	Text or Language	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. 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.
`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.
`locationCreated`	Place	The location where the CreativeWork was created, which may not be the same as the location depicted in the CreativeWork.
`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.
`position`	Integer or Text	The position of an item in a series or sequence of items.
`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.
`publisherImprint`	Organization	The publishing division which published the comic.
`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.
`releasedEvent`	PublicationEvent	The place and time the release was issued, expressed as a PublicationEvent.
`review`	Review	A review of the item. Supersedes reviews.
`schemaVersion`	URL or Text	Indicates (by URL or string) a particular version of a schema used in some CreativeWork. For example, a document could declare a schemaVersion using a URL such as http://schema.org/version/2.0/ if precise indication of schema version was required by some application.
`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'.
`translationOfWork`	CreativeWork	The work that this work has been translated from. e.g. 物种起源 is a translationOf “On the Origin of Species” Inverse property: workTranslation.
`translator`	Organization or Person	An agent responsible for rendering a translated work from a source work
`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.
`workTranslation`	CreativeWork	A work that is a translation of the content of this work. e.g. 西遊記 has an English workTranslation “Journey to the West”,a German workTranslation “Monkeys Pilgerfahrt” and a Vietnamese translation Tây du ký bình khảo. Inverse property: translationOfWork.
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`	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`	Organization or Brand or Place or Product	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`	VideoObject or ImageObject	Thumbnail image for an image or video.

More specific Types

Barcode

Examples

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>

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.
<!-- 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" 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" 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."
  }
  "exifData": {
    "@type": "PropertyValue",
    "name": "FNumber",
    "value": "f/4.0"
  }
  "exifData": {
    "@type": "PropertyValue",
    "name": "MaxApertureValue",
    "value": "2.00"
  }
  "exifData": {
    "@type": "PropertyValue",
    "name": "Metering Mode",
    "value": "Pattern"
  }
  "exifData": {
    "@type": "PropertyValue",
    "name": "Flash",
    "value": "Flash did not fire."
  }    
}
</script>

Schema Version 2.2

bib.schema.org

ImageObject

Thing > CreativeWork > MediaObject > ImageObject