This page details the major updates made to Media Actions documentation. To see changes that
only apply to the feature that you work on, use the filter to select a feature.
Filter by feature Listen Actions Watch Actions Play Game Actions

## October 2026

- **October 30** : Updated Live TV and `SportsEvent` documentation and examples to remove unsupported standalone Video-on-demand `SportsEvent` feeds, place sports event deep links on `SportsEvent.potentialAction` (instead of `BroadcastEvent.potentialAction`), clarify `availabilityStarts` (14-day pre-roll) and `availabilityEnds` (2--3 hour overtime buffer) windows, include `parentOrganization` with Wikipedia `sameAs` URLs on both `homeTeam` and `awayTeam`, clarify that `BroadcastEvent` and `SportsEvent` must not include `url`, and reinforce contiguous 4-hour maximum `offAir` schedule blocks.
- **October 30** : Removed references to the retired Data Feed Validation tool in favor of the [JSON Schema Validation tool](https://developers.google.com/actions/media/tools/jsonschemas) and [Catalog Properties on Search Console](https://developers.google.com/actions/media/how-to/monitor-the-feed).

## September 2026

- **September 24**: Updated the Media Actions devsite documentation to prepare for additional surface support including Google Play and Gemini.

## January 2026

- **January 8** : Updated `inLanguage` to be a highly recommended property.

## September 2025

- **September 17**: Expanded upon the Play Game Actions examples for Internationalization
- **September 18**: Expanded upon the Watch Actions identifier examples to show usage of multiple identifiers

## August 2025

- **August 20** : Added support for `actionAccessibilityRequirement.additionalProperty` to allow partners to specify the subscription package to be displayed to the user.

## May 2025

- **May 1** :Corrected naming of `audioDescription` to `audioDescriptionLanguage` in `target.additionalProperty` section of the [Action markup properties](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification) specification.

## March 2025

- **March 5** :Added `audioDescription` to the `target.additionalProperty` section of the [Action markup properties](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification) specification.
- **March 28** :Update `contentRating` description for multiple agencies in the `BroadcastService` Specification table section of the [BroadcastService](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification) specification.

## February 2025

- **February 10** :Added `availabilityStarts` and `availabilityEnds` requirements on `SportsEvent` watch action link in [Sports content](https://developers.google.com/actions/media/concepts/sports_events) specification.
- **February 20** :Added a new example with Geoshape on `SportsEvent` watch action link in [Sports content](https://developers.google.com/actions/media/concepts/sports_events) specification.

## August 2024

- **August 1** :Removed `Text` from expected type of `contentRating.author` property in [Movies](https://developers.google.com/actions/media/reference/data-specification/movies-specification), [TV Shows](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification), [BroadcastService](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification), and [BroadcastEvent](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastevent-specification) specification.

## April 2024

- **April 1** :Removed `availabilityStarts` requirement on `SportsEvent` watch action link in [Sports content](https://developers.google.com/actions/media/concepts/sports_events) specification.
- **April 2** :Update `BroadcastEvent` for location markup [SportsEvent](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastevent-specification) specification.

## March 2024

- **March 7** :Added sports team `parentOrganization` for league markup to [SportsEvent](https://developers.google.com/actions/media/reference/data-specification/events-specification) specification.

## June 2023

- **June 15** :Added `identifier` and `contentRating` properties to the [BroadcastEvent](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastevent-specification) specification.
- **June 15**:Enhanced Live TV documentation throughout the developer documentation. Added new entity modeling guidance, and several more examples.
- **June 15** :Added additional guidance and examples for [Live TV channel](https://developers.google.com/actions/media/concepts/live-tv-channel) modeling.
- **June 15** :Added additional guidance and examples for [Live TV schedule](https://developers.google.com/actions/media/concepts/live-tv-event) modeling.

## May 2023

- **May 20** :Added enhanced `actor` spectifications for [TV Shows](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification) in the Media Actions feed.

## March 2023

- **March 8** :Added guidance on modeling [Sports content](https://developers.google.com/actions/media/concepts/sports_events) in the Media Actions feed.

<!-- -->

- **March 7** :Updates to the [Quality checklist](https://developers.google.com/actions/media/tools/quality-checklist) sections.

## February 2023

- **February 20** :Updates to the [Create a Feed](https://developers.google.com/actions/media/how-to/create-a-feed) and [Host the Feed](https://developers.google.com/actions/media/how-to/host-the-feed) sections

## January 2023

- **January 3** :Added `datePublished` and `expires` as accepted properties to images, give example usage.

## November 2022

- **November 15** :Added `VIP_TIMES_ID` as an accepted propertyID.

## October 2022

- **October 22** :Updated `identifier` to be a highly recommended property.
- **October 20** :Updated the [Identifiers](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#identifiers) section to call out EIDR identifiers. Also added relevant examples in the [Watch Action Examples](https://developers.google.com/actions/media/reference/feed-examples/watch-actions-examples#eidr-example) reference pages.

## December 2022

- **December 21**: Added the following pages.

## August 2022

- **August 23**:Actions on Google (AoG) Console tool has been deprecated in favor of Catalog Properties on Search Console.

## December 2021

- **December 16** :Updated `releasedEvent` to be a highly recommended property.

## November 2021

- **November 5** :Added `producer` as a highly recommended property to the [TVSeries](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries), [TVSeason](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason), [TVEpisodes](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode), and [Movie](https://developers.google.com/actions/media/reference/data-specification/movies-specification) specification pages.

## October 2021

- **October 7** : Updated documentation links for Search Console [entity lookup](https://support.google.com/webmasters/answer/10432298) and [feed report](https://support.google.com/webmasters/answer/10063924).
- **October 6** : Updated `https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification.channelOrder` to be a required property for GoogleTV.
- **October 4** : Updated `contentRating` to accept "RATING NOT KNOWN" as a potential value.

## September 2021

- **September 9** : Updated `releasedEvent.publishedBy` to be an optional property.

## August 2021

- **August 11** : Updated Watch Action deep link [autoplay guidelines](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#playback-all) from required to recommended for Search platform.

## July 2021

- **July 23** : Updated `popularityScore` to be a highly recommended property

## June 2021

- **June 13** : Removed the requirement of the `_PARTNER_ID_` identifier property in the [BroadcastService](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification) entity.
- **June 13** : Removed `MediaService` specification from the JSON Schema requirements.

## May 2021

- **May 19**: Updated autoplay requirements for Watch and Listen Actions.
- **May 13** : Added `editEidr` as a highly recommended property to the [TVEpisodes](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification) specification, and `titleEidr` as a highly recommended property to the [TVSeason](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification) specification page.
- **May 07** : Added schema support for various [clip](https://developers.google.com/actions/media/reference/data-specification/clips) types, which include `Preview`, `Recap`, `Review`, `Highlight`, `Blooper`, `BehindTheScene`, `DeletedScene`, and `Interview`.
- **May 04** : Added new information about how to monitor the status of your feed ingestion through [`Search Console`](https://developers.google.com/actions/media/how-to/monitor-the-feed).
- **May 04** : Updated information about the [`tools`](https://developers.google.com/actions/media/how-to/create-a-feed#validate_the_sample_feed) available for validation of sample feed.

## April 2021

- **April 26** : Added `editEidr` as a highly recommended property to the [Movie](https://developers.google.com/actions/media/reference/data-specification/movies-specification) specification page.

## March 2021

- **March 26** : Added new reference information about how to supply film variants for [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) entities.
- **March 15** : Fixed the JSON Schema of the `commonTier` attribute on `MediaSubscription` to validate the requirement on lists as well as single object.

<!-- -->

- **March 1** : Added `MediaService` to the JSON Schema.

## February 2021

- **February 12**: Added description to the Radio Specification example

## January 2021

- **January 14**: Added an example on how to mark up local channels.
- **January 10** : Updated brand icon requirements for Google TV in the [MediaService](https://developers.google.com/actions/media/reference/data-specification/live-tv/mediaservice-specification) specification.
- **January 4** : Added Radio JSON Schema to validate `RadioBroadcastService` entities.

## December 2020

- **December 30** : Added `offAir` and `contentToBeAnnounced` properties to [BroadcastEvent](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastevent-specification).
- **December 30** : Updated `image` to be a required property for [TVSeries,
  TVEpisodes](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification) and [Movies](https://developers.google.com/actions/media/reference/data-specification/movies-specification).
- **December 30**: Updated brand icon requirements for Google TV.
- **December 30** : Added `channelOrder` property to [TelevisionChannel](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification).
- **December 30** : Updated [BroadcastService](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification).`logo` as a required property for GoogleTV integration, highly recommended otherwise. Also added recommended aspect ratios for the same.
- **December 28** : Added `titleEidr` as a highly recommended property to the [TV](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification) and [Movie](https://developers.google.com/actions/media/reference/data-specification/movies-specification) specification pages.
- **December 9** : Added `duration` as an optional property to the TVEpisode [specification page](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode).
- **December 3** : Updated the `releasedEvent` property to accept `FeaturedEvent` which indicates how your service is marketed, and `ExclusiveEvent` which indicates that the content has exclusive distribution rights. Added related properties to the [`Movies`](https://developers.google.com/actions/media/reference/data-specification/movies-specification), [`TVSeries`](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), [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification), and [`Events`](https://developers.google.com/actions/media/reference/data-specification/events-specification#event_specification_table) reference tables. Added examples to the [Watch Actions feed examples](https://developers.google.com/actions/media/reference/feed-examples/watch-actions-examples) page.

## November 2020

- **November 11**: Add advisoryCode as a property of contentRating
- **November 10**: Removed requirement for trailers to be hosted on YouTube.
- **November 2** : [MediaService](https://developers.google.com/actions/media/reference/data-specification/mediaservice-specification) entity should be created in the `media_config.json` file.
- **November 2** : [MediaService](https://developers.google.com/actions/media/reference/data-specification/mediaservice-specification) property changed from `logo` to `brandIcon`.

## October 2020

- **October 27** : Added two image examples to the [Image properties](https://developers.google.com/actions/media/reference/data-specification/image-properties#examples-with-intended-use) page.
- **October 9** : Added a new reference page for the [`MediaService` entity type](https://developers.google.com/actions/media/reference/data-specification/mediaservice-specification), which is required as part of every Media Actions, specifically Watch Actions, feed submission.

## August 2020

- **August 13** : Made [requiresSubscription.identifier](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#media_subscription_properties) required when access category is subscription.

## July 2020

- **July 27** : Made the `commonTier` property required in the JSON Schemas when the `category` is subscription and allowing `actor` to be represented with the `PerformanceRole` object in the JSON Schema.
- **July 14** : Fixed the music JSON Schema, to allow multiple creators to be set in the `MusicPlaylist` entities.
- **July 13** : Updated steps for monitoring the status of a feed on the create an actions [project](https://developers.google.com/actions/media/how-to/monitor-the-feed#create_an_actions_project) page.
- **July 10** : Fixed the validations in the JSON Schema. The `category` property in the `Offer` object was not set properly and was ignored in the Music Schema.
  - Allow `http://schema.googleapis.com/` in the `@context` property.
  - Add `availabilityStarts` and `availabilityEnds` in the `Offer` object in the Music Schema.
  - Add `eligibleRegion` to be a requirement in the `Offer` in the Music Schema.
  - Updated the `Rating` object to authorize a string for author.
- **July 9** : Allow `intent://` pattern in addition to `android-app://` for android deeplinks in the JSON Schemas.
- **July 7** : Clarified correct use of `TMS_ROOT_ID` vs `TMS_ID` for `LiveTV` partners on the [identifier](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#identifier_properties) page.
- **July 6** : Added the sport property to `https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table`.
- **July 6** : Updated `startDate` and `endDate` types for `https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table` from `Date` to `Date` or `DateTime`.
- **July 6** : Made the following `https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table` properties highly recommended: `homeTeam`, `homeTeam.sameAs`, `awayTeam`, `competitor`, `identifier`.

## June 2020

- **June 30** : Updated the JSON Schemas to add the `commonTier` property in the `MediaSubscription` object, and modified the `identifier` property to only check the value before the `:` to leave more freedom on the package string.
- **June 25** : Updated requirements on `SportsTeam` and clarified `startDate` in [`Events`](https://developers.google.com/actions/media/reference/data-specification/events-specification).
- **June 24** : Made `requiresSubscription` required for providers with single tiered packages.
- **June 22** : Added details about the common tier to the [Access requirements](https://developers.google.com/actions/media/concepts/access-requirements) page. Updated [Watch
  actions common specification](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification) with common tier details.
- **June 1** : Consolidated entitlements content from several pages into one [Access requirements](https://developers.google.com/actions/media/concepts/access-requirements) page.

## May 2020

- **May 25** : Added [highly recommended](https://developers.google.com/actions/media/collect-information/collect-the-metadata) `inLanguage` and `category` properties to the [BroadcastService](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification#broadcastservice_specification_table) specification table.
- **May 20** : Made `areaServed` required for [`BroadcastService`](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification#boradcastservice_specification_table) if channel switch is [fulfilled by TV service provider](https://developers.google.com/actions/media/concepts/live-tv-channel#fulfilled_by_tv_service_provider).
- **May 19** : Made `areaServed` required for [`CableOrSatelliteService`](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification#cableorsatelliteservice_specification_table).
- **May 19** : Require `potentialAction` for [`Organization`](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification#organization_specification_table) when multiple channels ([`BroadcastService`](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification#broadcastservice_specification_table)) refer to it.

## April 2020

- **April 30** : Recategorized `sameAs` as [highly recommended](https://developers.google.com/actions/media/collect-information/collect-the-metadata) to improve reconcilitaion quality.
- **April 28** : Fixed the [JSON Schemas](https://developers.google.com/actions/media/tools/jsonschemas) by updating `minIntems` to `minItems` for the `region` property.
- **April 26** : Fixed the [Live TV JSON schema](https://developers.google.com/actions/media/tools/jsonschemas) by updating the reference of the `identifier` property for `CableOrSatelliteService` entity type. Allow the validation of this entity type when it contains the `identifier` property.
- **April 23** : Recategorized `BroadcastService.logo` as [highly recommended](https://developers.google.com/actions/media/collect-information/collect-the-metadata) to improve reconcilitaion quality.
- **April 16** : Updated the [Watch Action playback behavior policy](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#watch_actions_playback_behavior) to include new requirements.

## March 2020

- **March 19** : Added a new [Use deep links to initiate playback](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#universal-link) section.
- **March 12** : For the `LiveTV` specification, [`url` is now a required property for `BroadcastService`](https://developers.google.com/actions/media/reference/data-specification/live-tv/broadcastservice-specification). It's optional for a service delivered on cable, satellite, or over the air.
- **March 10** : Updated the [Rating Agencies table](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#content_rating_agencies) to include more countries and more specific guidance.
- **March 3** : Added new reference information about [how to supply images for Movies and TV Shows](https://developers.google.com/actions/media/reference/data-specification/image-properties).