Note: You are viewing the development version of Schema.org. See how we work for more details.

ImageObject

A Schema.org Type
An image file.
PropertyExpected TypeDescription
Properties from ImageObject
caption MediaObject  or
Text
The caption for this object. For downloadable machine formats (closed caption, subtitles etc.) use MediaObject and indicate the encodingFormat.
embeddedTextCaption Text Represents textual captioning from a MediaObject, e.g. text of a 'meme'.
exifData PropertyValue  or
Text
exif data for this object.
representativeOfPage Boolean Indicates whether this image is representative of the content of the page.
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  or
QuantitativeValue
The duration of the item (movie, audio recording, event, etc.) in ISO 8601 duration 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.
Inverse property: encoding
encodingFormat Text  or
URL
Media type typically expressed using a MIME format (see IANA site and MDN reference), e.g. application/zip for a SoftwareApplication binary, audio/mpeg for .mp3 etc.

In cases where a CreativeWork has several media type representations, encoding can be used to indicate each MediaObject alongside particular encodingFormat information.

Unregistered or niche encoding and file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia/Wikidata entry. Supersedes fileFormat.
endTime DateTime  or
Time
The endTime of something. For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to end. For actions that span a period of time, when the action was performed. E.g. John wrote a book from January to December. For media, including audio and video, it's the time offset of the end of a clip within a larger file.

Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions.
height Distance  or
QuantitativeValue
The height of the item.
ineligibleRegion GeoShape  or
Place  or
Text
The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is not valid, e.g. a region where the transaction is not allowed.

See also eligibleRegion.
interpretedAsClaim Claim Used to indicate a specific claim contained, implied, translated or refined from the content of a MediaObject or other CreativeWork. The interpreting party can be indicated using claimInterpreter.
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  or
MediaSubscription
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').
sha256 Text The SHA-2 SHA256 hash of the content of the item. For example, a zero-length input has value 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855'.
startTime DateTime  or
Time
The startTime of something. For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to start. For actions that span a period of time, when the action was performed. E.g. John wrote a book from January to December. For media, including audio and video, it's the time offset of the start of a clip within a larger file.

Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions.
uploadDate Date  or
DateTime
Date (including time if available) 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 an object.
Inverse property: subjectOf
abstract Text An abstract is a short description that summarizes a CreativeWork.
accessMode Text The human sensory perceptual system or cognitive faculty through which a person may process or perceive the intellectual content of a resource, not including any adaptations of the content (e.g., text alternatives for images). Values should be drawn from the approved vocabulary.
accessModeSufficient ItemList A list of single or combined access modes that are sufficient to understand all the intellectual content of a resource, including any adaptations. Values should be drawn from the approved vocabulary.
accessibilityAPI Text Indicates that the resource is compatible with the referenced accessibility API. Values should be drawn from the approved vocabulary.
accessibilityControl Text Identifies input methods that are sufficient to fully control the described resource. Values should be drawn from the approved vocabulary.
accessibilityFeature Text Content features of the resource, such as accessible media, alternatives and supported enhancements for accessibility. Values should be drawn from the approved vocabulary.
accessibilityHazard Text A characteristic of the described resource that is physiologically dangerous to some users. Related to WCAG 2.0 guideline 2.3. Values should be drawn from the approved vocabulary.
accessibilitySummary Text A human-readable summary of specific accessibility features or deficiencies, consistent with the other accessibility metadata but expressing subtleties such as "short descriptions are present but long descriptions will be needed for non-visual users" or "short descriptions are present and no long descriptions are needed".
accountablePerson Person Specifies the Person that is legally accountable for the CreativeWork.
acquireLicensePage CreativeWork  or
URL
Indicates a page documenting how licenses can be purchased or otherwise acquired, for the current item.
aggregateRating AggregateRating The overall rating, based on a collection of reviews or ratings, of the item.
alternativeHeadline