Collect the metadata of your content

Google uses the metadata properties to reconcile the content in your feed with the content in Google's databases; the more metadata you provide for your content, the better Google can match the content.

The following metadata are recommended for each entity type:

Movie description, duration, actor, director, image, releasedEvent, sameAs, trailer, and identifier.
TVEpisode description, actor, image, releasedEvent, sameAs, trailer, and identifier.
TVSeries description, actor, image, releasedEvent, sameAs, trailer, and identifier.
TVSeasons description, actor, image, releasedEvent, sameAs, trailer, and identifier.
BroadcastService description, alternateName, callSign, contentRating, slogan, areaServed, logo, sameAs, videoFormat, broadcastTimezone, and identifier.
MusicGroup description, image, sameAs, and isFamilyFriendly.
MusicAlbum description, image, sameAs, isFamilyFriendly, numTracks, and timeRequired.
MusicRecording description, image, sameAs, isFamilyFriendly, duration, and inAlbum.
MusicPlaylist description, image, creator,keywords, and isFamilyFriendly.
RadioBroadcastService alternateName, callSign, slogan, areaServed, logo, popularityScore, inLanguage, sameAs, identifier, and keywords.

Descriptions

The following list contains the descriptions of the recommended properties:

  • sameAs: A URL to a web page that references the content; for example, a movie's IMDB page or Wikipedia page.
  • trailer.description: The description of the content's trailer.
  • trailer.inLanguage: The language of the trailer.
  • trailer.url: The URL of the trailer hosted on YouTube.
  • trailer.regionsAllowed: The regions where the trailer is allowed. (Type: Place)
  • releasedEvent: The details about the release of the content. (Type: PublicationEvent)
  • identifier: An externally recognizable ID that can identify this content. Multiple identifiers are allowed.
  • isFamilyFriendly: An indicator that tells whether the content is family friendly.
  • timeRequired: The length of the album.
  • inAlbum.id: The @id of the album on which this MusicRecording appears.
  • inAlbum.name: The name of the album on which this MusicRecording appears.
  • creator: The creator of the playlist; it indicates that the playlist is created by your service or a high interest user of your service. (Type: Organization or Person)
  • keywords: A list of words that are associated with the content.
  • alternateName: An alternate name that helps users identify the broadcast service.
  • callSign: The official government-issued callsign of the broadcast service.
  • contentRating: The official rating of the content. For example, "_USAPARENTAL TV-Y". For an adult only TV broadcast service, this is required.
  • slogan: The slogan of the broadcast service.
  • areaServed: The area where the broadcast service is available.
  • logo: A logo image of the broadcast station. (Type: ImageObject)
  • videoFormat: The highest quality definition supported by the broadcast service.
  • broadcastTimezone: The timezone of the broadcast service.
  • popularityScore: A popularity score that helps determine the serving priority when there are multiple candidates.
  • inLanguage: The language of the program broadcast on this radio station.

Example

Example of the recommended properties of a Movie entity.

{
  ...
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is my favorite TV show.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ]
  ...
}

Collect the metadata

Do the following:

  1. Identify the recommended properties of your content.
  2. Gather and organize the metadata information in one place.