MediaObject
A media object, such as an image, video, audio, or text object embedded in a web page or a downloadable dataset i.e. DataDownload. Note that a creative work may have many media objects associated with it on the same web page. For example, a page about a single song (MusicRecording) may have a music video (VideoObject), and a high and low bandwidth audio stream (2 AudioObject's).
Build MediaObject JSON-LD
Loading the builder…
More specific types
Use the most specific type that fits. Each accepts every property of MediaObject.
Properties (149)
| Property | Expects | Description |
|---|---|---|
| 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, 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. |
| encodingFormat | Text, 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. |
| endTime | DateTime, 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, QuantitativeValue | The height of the item. |
| ineligibleRegion | GeoShape, Place, 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, 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, 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, DateTime | Date (including time if available) when this media object was uploaded to this site. |
| width | Distance, QuantitativeValue | The width of the item. |
From CreativeWork (116)
about, abstract, accessMode, accessModeSufficient, accessibilityAPI, accessibilityControl, accessibilityFeature, accessibilityHazard, accessibilitySummary, accountablePerson, acquireLicensePage, aggregateRating, alternativeHeadline, archivedAt, assesses, associatedMedia, audience, audio, author, award, awards, character, citation, comment, commentCount, conditionsOfAccess, contentLocation, contentRating, contentReferenceTime, contributor, copyrightHolder, copyrightNotice, copyrightYear, correction, countryOfOrigin, creativeWorkStatus, creator, creditText, dateCreated, dateModified, datePublished, digitalSourceType, discussionUrl, displayLocation, editEIDR, editor, educationalAlignment, educationalLevel, educationalUse, encoding, encodingFormat, encodings, exampleOfWork, expires, fileFormat, funder, funding, genre, hasPart, headline, inLanguage, interactionStatistic, interactivityType, interpretedAsClaim, isAccessibleForFree, isBasedOn, isBasedOnUrl, isFamilyFriendly, isPartOf, keywords, learningResourceType, license, locationCreated, mainEntity, maintainer, material, materialExtent, mentions, offers, pattern, position, producer, provider, publication, publisher, publisherImprint, publishingPrinciples, recordedAt, releasedEvent, review, reviews, schemaVersion, sdDatePublished, sdLicense, sdPublisher, size, sourceOrganization, spatial, spatialCoverage, sponsor, teaches, temporal, temporalCoverage, text, thumbnail, thumbnailUrl, timeRequired, translationOfWork, translator, typicalAgeRange, usageInfo, version, video, wordCount, workExample, workTranslation
Where MediaObject is used as a value
These properties expect a MediaObject: afterMedia, associatedMedia, beforeMedia, caption, duringMedia, encoding, encodings, mediaItemAppearance, originalMediaLink.