This section details the content markup properties of `image` for movies, TV shows, live TV broadcasts, and sports events. This markup allows providers to describe the type of image, such as if it's a title, background, or iconic image, and its suggested use. > [!NOTE] > **Note:** Providers who supply images need to also authorize Google to use these images through the Content License Agreement (CLA). Work with your Google contact to ensure this is in place. ## Specification table The `image` property can be supplied for [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification), [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification), [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification), [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification), [`SportsEvent`](https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table), or [`BroadcastEvent`](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastevent-specification) entity types. The following table describes the available properties for the `image` property. Notice that the property `additionalProperty` includes a custom property name called [`contentAttributes`](https://developers.google.com/actions/media/reference/data-specification/image-properties#contentAttributes), which holds an array of values that describe the type of image and its intended use. | Property | Expected Type | Description | |---|---|---| | `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `"http://schema.org"`. | | `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `ImageObject`. | | `contentUrl` | [URL](https://schema.org/URL) | **Required** - The URL of the image. | | `additionalProperty` | [PropertyValue](https://schema.org/PropertyValue) | **Required** - Defines the property `contentAttributes`, which describes the image type and its intended use. For more details, read [`contentAttributes`](https://developers.google.com/actions/media/reference/data-specification/image-properties#contentAttributes). | | `character` | [Person](https://schema.org/Person) | **Required if applicable** - A fictional character associated with the image. This is required if `contentAttribute` includes `castInCharacter`. > [!NOTE] > **Note:** You can use the `Person` type here even if the character isn't human. | | `inLanguage` | [Text](http://schema.org/Text) | **Required if applicable** - The language of text used in the image. Use one of the language codes from the [IETF BCP 47 standard](http://tools.ietf.org/html/bcp47). If the image includes a `contentAttribute` of `hasTitle`, this property is required. | | `regionsAllowed` | [Place](https://schema.org/Place) | **Recommended** - The regions where the image is allowed. If not specified, then it's assumed that the image is allowed everywhere. Specify the countries in [ISO 3166 format](http://en.wikipedia.org/wiki/ISO_3166). | | `datePublished` | [Date](http://schema.org/Date) | **Required if applicable** - Date after which the image is available, in [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601) (including timezone). - The date can be set in the future.
If there are time-based restrictions on the usage of the image, this property is required if the image must not be displayed before the given date. If no such restriction exists it can be omitted. It is required that the corresponding image be provided in the feed at least 7 days ahead of its datePublished. This will enhance the chances of the content showing up on Google surfaces on time. | | `expires` | [Date](http://schema.org/Date) | **Required if applicable** - Date after which the image is no longer available, in [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601) (including timezone). - If the content is always available after it's published, you can omit this property.
It is required that any updates to the expires date be made in the feed at least 7 days before the expiry date. This will enhance the chances of the content ceasing to appear on Google surfaces on the expiry date. | | `audience` | [Audience](https://schema.org/Audience) | **Recommended** - The intended or preferred audience for this image. | | `audience.geographicArea` | [AdministrativeArea](https://schema.org/AdministrativeArea) | **Recommended** - The intended or preferred regions for this image. In contrast, use `regionsAllowed` to specify hard restrictions. If `audience.geographicArea` isn't specified, then it's assumed to be intended for use everywhere. Specify the countries in [ISO 3166 format](http://en.wikipedia.org/wiki/ISO_3166). | | `copyrightHolder` | [Organization](https://schema.org/Organization) or [Person](https://schema.org/Person) | **Recommended** - The party that holds the copyright to the image. | | `keywords` | [Text](http://schema.org/Text) | **Recommended** - Keywords or tags used to describe this image. Multiple `keywords` can be provided using an array. For example, \["feature, biography"\] | | `name` | [Text](http://schema.org/Text) | **Recommended** - Name of the image. | | `width` | [Integer](https://schema.org/Integer) | **Optional** - Positive integer width of the image in pixels (for example, `1920`). Don't include unit strings such as `"px"`. | | `height` | [Integer](https://schema.org/Integer) | **Optional** - Positive integer height of the image in pixels (for example, `1080`). Don't include unit strings such as `"px"`. | ### contentAttributes The `contentAttributes` property of `image` describes the image's type and defines its suggested uses. The categories in the following list include the `contentAttributes` values that providers must include with each `ImageObject`. > [!NOTE] > **Note:** The values for `contentAttributes` are case-insensitive in the feed. #### Type - `iconic`: An illustrative image that exemplifies the show. Often an artistic rendering. - `sceneStill`: An image excerpt from the show. - `castInCharacter`: A photo of a cast member as they appear in character. If you use this value, also include the [`character`](https://schema.org/character) property to identify the specific character in the image. If there are multiple characters, such as in a cast ensemble, include multiple `character` properties as an array. - `logo`: The image contains only a logo. This can be either a graphical logo or a title logo. Include the corresponding [overlay](https://developers.google.com/actions/media/reference/data-specification/image-properties#overlays) to specify which. *To be valid, use one and only one of these types.* #### Recommended use - `poster`: A poster image for the show. In computer UIs, these can be used in carousels. These might or might not contain the title of the show. - `background`: An image suitable for use as a background with text or UI overlays. These images don't contain text. *To be valid, include at most one of these recommended uses.* #### Size suitability - `smallFormat`: An image that's suitable for smaller screens like mobile phones. Any text or logos in the image are legible on a small screen. - `largeFormat`: An image that's suitable for larger screens or printed posters. > [!NOTE] > **Note:** Generally, most images are suitable for large formats. The exceptions are those images with low resolution, which would look pixelated if scaled to a larger size. *An image can use both of these values.* #### Background suitability - `forDarkBackground`: An image, typically a transparent logo, that's suitable for use on a dark background. - `forLightBackground`: An image, typically a transparent logo, that's suitable for use on a light background. *To be valid, use at most one background suitability value.* #### Overlays - `hasTitle`: The title of the show, or the name of the character or actor included with the image. Be sure to include the `inLanguage` property for the image. - `noTitle`: The image doesn't include the title. - `hasLogo`: The image includes the logo of a movie or show, the content owner, or the distributor. - `noLogo`: The image doesn't include a logo. - `hasCopyright`: The image includes a visible copyright notice. - `noCopyright`: The image doesn't include a visible copyright notice. Google generally can't use such images without modification. - `hasMatte`: The image has a matte. This could be horizontal (letterbox), vertical (pillarbox), or both (windowbox). Sometimes images are matted to fit into an aspect ratio. Google generally can't use such images without modification. - `noMatte`: The image doesn't have a matte. - `transparentBackground`: The background of the image is transparent. This is typically used for images that are just a title or logo and nothing else. *To be valid, only one title, one logo, one copyright, and one matte attribute are allowed.* #### Position of predominant figure - `centered`: The predominant figure is positioned at the center of the image. - `rightCentered`: The predominant figure is positioned towards the right side of the image, which leaves the left side relatively empty for text and UI overlays. - `leftCentered`: The predominant figure is positioned towards the left side of the image, which leaves the right side relatively empty for text and UI overlays. *To be valid, include at most one of these positions.* ### Example images with their intended use ![](https://developers.google.com/static/actions/media/images/image-properties-1.png) A TV UI that shows a background image with text and UI overlay. ![](https://developers.google.com/static/actions/media/images/image-properties-2.png) A TV UI that shows carousels with poster images on a background image. ![](https://developers.google.com/static/actions/media/images/image-properties-3.png) A mobile UI with a poster image and a background `iconic` image. ![](https://developers.google.com/static/actions/media/images/image-properties-4.png) A mobile UI with a poster image and a background `sceneStill` image. *** ** * ** *** ### Example images and their contentAttributes ![](https://developers.google.com/static/actions/media/images/image-properties-5.png) `contentAttributes: ["iconic", "poster", "centered", "hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"]` ![](https://developers.google.com/static/actions/media/images/image-properties-6.png) `contentAttributes: ["iconic", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]` ![](https://developers.google.com/static/actions/media/images/image-properties-7.png) `contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]` ![](https://developers.google.com/static/actions/media/images/image-properties-8.png) `contentAttributes: ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]` ![](https://developers.google.com/static/actions/media/images/image-properties-9.png) `contentAttributes: ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]` ![](https://developers.google.com/static/actions/media/images/image-properties-10.png) `contentAttributes: ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]` ![](https://developers.google.com/static/actions/media/images/image-properties-11.png) `contentAttributes: ["castInCharacter", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character: {name: "Captain Pulsar"}` ![](https://developers.google.com/static/actions/media/images/image-properties-12.png) `contentAttributes: ["logo", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "smallFormat", "largeFormat"]` ![](https://developers.google.com/static/actions/media/images/image-properties-13.png) `contentAttributes: ["logo", "hasTitle", "hasLogo" "noCopyright", "noMatte", "centered", "transparentBackground", "forLightBackground", "forDarkBackground", "smallFormat", "largeFormat"]` ![](https://developers.google.com/static/actions/media/images/image-properties-14.png) `contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "noMatte"]` ![](https://developers.google.com/static/actions/media/images/image-properties-15.png) `contentAttributes: ["iconic", "poster", "centered", "noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat", "largeFormat"]` ![](https://developers.google.com/static/actions/media/images/image-properties-16.png) `contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "hasMatte"]` *** ** * ** *** ## Desired image types for Google products Different Google products and surfaces require different [image types](https://developers.google.com/actions/media/reference/data-specification/image-properties#contentAttributes) and aspect ratios. To ensure that content displays correctly on all Google products, we request that providers supply all of the image types from the following table. > [!NOTE] > **Note:** You must include all of the specified images types. If you don't supply Google with images, Google might not be able to display your movies and TV shows, even in products without images. Images are mandatory for launching on GoogleTV. For other surfaces, however, we only issue validation warnings, and not errors, if an image isn't included. | Aspect ratio and contentAttributes | Minimum resolution (pixels) | Movie | TV Series | TV Season | TV Episode | Broadcast Service | |---|---|---|---|---|---|---| | 16:9, `iconic` `poster` | 3840x2160 | Yes | Yes | Yes | Yes | | | 2:3, `iconic` `poster` | 1000x1500 | Yes | Yes | Yes | Yes | | | 4:3, `iconic` `poster` | 800x600 | Yes | Yes | Yes | Yes | | | 1:1, `iconic` `poster` | 600x600 | | Yes | | | | | 3:4, `iconic` `poster` | 600x800 | | Yes | Yes | | | | 16:9, `iconic` `background` \[preferred\] or `sceneStill` | 3840x2160 | Yes | Yes | Yes | Yes | | | 2:3, `iconic` `background` \[preferred\] or `sceneStill` | 1000x1500 | Yes | Yes | Yes | Yes | | | 3:4, `iconic` `background` \[preferred\] or `sceneStill` | 600x800 | | | Yes | | | | 1:1, Show logo (`hasLogo`) | 600x600 | | Yes | | | | | 4:3, Channel logo (`logo`) | 800x600 | | | | | Yes | | 1:1, Channel logo (`logo`) | 600x600 | | | | | Yes | | 16:9, Channel logo (`logo`) | 3840x2160 | | | | | Yes | | 9:5, `hasTitle` `logo` (with `transparentBackground` and both `forLightBackground` and `forDarkBackground`) | 1800x1000 | Yes | Yes | | | | The following guidelines apply when you submit images: 1. The images must be in JPEG, PNG, or WebP formats. 2. Include the highest-resolution images you have. 3. File sizes must not exceed 20 MB. 4. `centered` images are preferred. `rightCentered` and `leftCentered` background images can also be used by some products, so you can include them if you have them. 5. We prefer images that work for both `smallFormat` and `largeFormat`. 6. You can include image sizes in addition to the ones listed in the preceding table. 7. Verify that each image's aspect ratio is one of the common values listed in the preceding table. Otherwise, a warning is given. ## Example images with schema The following examples show how to format the schema for images associated with movies or TV shows. ### Movie background image with two characters ![](https://developers.google.com/static/actions/media/images/image-properties-8.png) { "@context": [ "http://schema.org", { "@language": "en" } ], "@type": "Movie", "@id": "http://www.example.com/mountain_view", "url": "http://www.example.com/my_favorite_movie", ..., "image": { "@context": "http://schema.org", "@type": "ImageObject", "name": "Mountain View: A Movie poster", "Keywords": ["Mauren, Lord Wingflap the Destroyer"], "contentUrl": "http://example.com/images/mountain-view.jpg", "character": [ { "@type": "Person", "name": "Mauren" }, { "@type": "Person", "name": "Lord Wingflap the Destoyer" }, ], "copyrightHolder": { "@type": "Organization", "name": " ExampleOrganization Studios, Inc." }, "inLanguage": "en-US", "audience": { "@type": "Audience", "geographicArea": [{"@type": "Country", "name": "US"}, {"@type": "Country", "name": "GB"}, {"@type": "Country", "name": "CA"}, {"@type": "Country", "name": "AU"}] }, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"] } ] } } ### TVSeries background image restricted to two regions ![](https://developers.google.com/static/actions/media/images/image-properties-8.png) { "@context": [ "http://schema.org", { "@language": "en" } ], "@type": "TVSeries", "@id": "http://www.example.com/mountain_view", "url": "http://www.example.com/mountain_view", ..., "image": { "@context": "http://schema.org", "@type": "ImageObject", "name": "Mountain View: A TV Show", "contentUrl": "http://example.com/images/mountain-view.jpg", "copyrightHolder": { "@type": "Organization", "name": "ExampleOrganization Studios, Inc." }, "inLanguage": "en-US", "regionsAllowed": [{ "@type": "Country", "name": "US" }, { "@type": "Country", "name": "GB" }], "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"] } ] } } ### Movie poster image intended for two regions ![](https://developers.google.com/static/actions/media/images/image-properties-9.png) { "@context": [ "http://schema.org", { "@language": "en" } ], "@type": "Movie", "@id": "http://www.example.com/pulsar_quest", "url": "http://www.example.com/pulsar_quest", ..., "image": { "@context": "http://schema.org", "@type": "ImageObject", "name": "Pulsar Quest: A New Frontier", "contentUrl": "http://example.com/images/pulsar-quest.jpg", "copyrightHolder": { "@type": "Organization", "name": "ExampleOrganization Studios, Inc." }, "inLanguage": "en-US", "audience": [{ "@type": "Country", "name": "US" }, { "@type": "Country", "name": "GB" }], "character": [ { "@type": "Person", "name": "Captain Pulsar" } ], "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"] } ] } } ### Large format movie poster with both Korean and English ![](https://developers.google.com/static/actions/media/images/image-properties-17.png) { "@context": [ "http://schema.org", { "@language": "en" } ], "@type": "Movie", "@id": "http://www.example.com/pulsar_quest", "url": "http://www.example.com/pulsar_quest", ..., "image": { "@context": "http://schema.org", "@type": "ImageObject", "name": "Pulsar Quest: A New Frontier poster", "contentUrl": "http://example.com/images/pulsar-quest.jpg", "copyrightHolder": { "@type": "Organization", "name": "ExampleOrganization Studios, Inc." }, "inLanguage": ["kr", "en"], "audience": { "@type": "Country", "name": "KR" }, "character": [ { "@type": "Person", "name": "Captain Pulsar" }, { "@type": "Person", "name": "Space Cadet Shaniah" }, { "@type": "Person", "name": "Rove the Rover" }, ], "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"] } ] } } ### Representing multiple images per region { "@context": [ "http://schema.org", { "@language": "en" } ], "@type": "Movie", "@id": "http://www.example.com/pulsar_quest", "url": "http://www.example.com/pulsar_quest", ..., "image": [{ "@context": "http://schema.org", "@type": "ImageObject", "name": "Pulsar Quest: A New Frontier poster", "contentUrl": "http://example.com/images/pulsar-quest-us.jpg", "copyrightHolder": { "@type": "Organization", "name": "ExampleOrganization Studios, Inc." }, "inLanguage": ["en"], "audience": { "@type": "Country", "name": "US" }, "character": [ { "@type": "Person", "name": "Captain Pulsar" }, { "@type": "Person", "name": "Space Cadet Shaniah" }, { "@type": "Person", "name": "Rove the Rover" } ], "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"] } ] },{ "@context": "http://schema.org", "@type": "ImageObject", "name": "Pulsar Quest: A New Frontier poster", "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg", "copyrightHolder": { "@type": "Organization", "name": "ExampleOrganization Studios, Inc." }, "inLanguage": ["kr"], "audience": { "@type": "Country", "name": "KR" }, "character": [ { "@type": "Person", "name": "Captain Pulsar" }, { "@type": "Person", "name": "Space Cadet Shaniah" }, { "@type": "Person", "name": "Rove the Rover" } ], "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"] } ] }] } ### Representing time-restricted images { "@context": [ "http://schema.org", { "@language": "en" } ], "@type": "Movie", "@id": "http://www.example.com/pulsar_quest", "url": "http://www.example.com/pulsar_quest", ..., "image": [{ "@context": "http://schema.org", "@type": "ImageObject", "name": "Pulsar Quest: A New Frontier poster", "contentUrl": "http://example.com/images/pulsar-quest-jp.jpg", "copyrightHolder": { "@type": "Organization", "name": "ExampleOrganization Studios, Inc." }, "datePublished": "2022-10-31T17:00:00Z", "expires": "2025-10-31T16:59:59Z", "inLanguage": ["ja"], "audience": { "@type": "Country", "name": "JP" }, "character": [ { "@type": "Person", "name": "Captain Pulsar" }, { "@type": "Person", "name": "Space Cadet Shaniah" }, { "@type": "Person", "name": "Rove the Rover" } ], "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"] } ] },{ "@context": "http://schema.org", "@type": "ImageObject", "name": "Pulsar Quest: A New Frontier poster", "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg", "copyrightHolder": { "@type": "Organization", "name": "ExampleOrganization Studios, Inc." }, "datePublished": "2021-10-31T17:00:00Z", "expires": "2023-10-31T16:59:59Z", "inLanguage": ["kr"], "audience": { "@type": "Country", "name": "KR" }, "character": [ { "@type": "Person", "name": "Captain Pulsar" }, { "@type": "Person", "name": "Space Cadet Shaniah" }, { "@type": "Person", "name": "Rove the Rover" } ], "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"] } ] }] }