ImageObject
A Schema.org Type
Usage:
10M+ Domains
Based on monthly aggregations from Google's web index.
(Google - August 2026)
- Canonical URL: https://schema.org/ImageObject
- Equivalent Class: dctype:Image
- Check for open issues.
An image file.
| Property | Expected Type | Description |
|---|---|---|
| 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 |
||