# MediaObject

This type is derived from <https://schema.org/MediaObject>, which means that any of this type's properties within schema.org may also be used. Note however the properties on this page must be used in preference if a relevant property is available.

## **Properties**

### **Required properties**

| Property | Expected Type                     | Description                                                                                                                               |
| -------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| @type    | [`Text`](https://schema.org/Text) | Must always be present and set to `"@type": "MediaObject"`                                                                                |
| url      | [`URL`](https://schema.org/URL)   | <p>The URL for the page containing the media.</p><p><br>Example</p><p><code>"url": "<https://example.com/media/stayin/getfit>"</code></p> |

### **Optional properties**

| Property   | Expected Type                                                                          | Description                                                                                                                                                                                                                                                                           |
| ---------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| contentUrl | [`URL`](https://schema.org/URL)                                                        | <p>Actual bytes of the media object, for example the image file or video file.</p><p><br>Example</p><p><code>"contentUrl": "<https://example.com/media/stayin/getfit>"</code></p>                                                                                                     |
| embedUrl   | [`URL`](https://schema.org/URL)                                                        | <p>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.</p><p><br>Example</p><p><code>"embedUrl": "<https://example.com/media/stayin/getfit>"</code></p> |
| height     | [`Integer`](https://schema.org/Integer)                                                | <p>The height of the media in pixels.</p><p><br>Example</p><p><code>"height": 300</code></p>                                                                                                                                                                                          |
| thumbnail  | Array of [`ImageObject`](https://developer.openactive.io/data-model/types/imageobject) | The URL for a thumbnail image for the media.                                                                                                                                                                                                                                          |
| width      | [`Integer`](https://schema.org/Integer)                                                | <p>The width of the media in pixels.</p><p><br>Example</p><p><code>"width": 400</code></p>                                                                                                                                                                                            |

Except as otherwise noted, the content of this page is licensed under the [Creative Commons Attribution License (CC-BY V4.0)](https://creativecommons.org/licenses/by/4.0/), and code samples are licensed under the [MIT License](https://opensource.org/licenses/MIT), for anyone to access, use and share; using attribution "[OpenActive](https://www.openactive.io/)".