Collect the ID, URL, and name of your content

All the entities in your catalog require the following properties:

Example of @id, url, and name:

"@id": "",
"url": "",
"name": "My example episode",


An identifier (@id) must meet the following requirements:

  • Globally unique across your catalog
    • For instance, don't use the same @id for a TVSeries and a TVSeason.
  • Static
    • You cannot change @id later.
  • In the form of Unified Resource Identifier (URI)
    • If your content's local identifier (ID) is not in a URI format, prepend your domain to the ID to satisfy this requirement; for example, if your content's ID is 1234abc and your domain is, @id can be
    • @id does not have to be a working URL; it only needs to be in a URI format.
    • The domain used in @id (for example, must be owned by your organization.

Because an entity's url meets all the requirements as an identifier (that is, globally unique, static, and in the form of a URI), we recommend you use an entity's url as @id.

Canonical URL

A canonical URL (url) helps Google accurately reconcile the content in your catalog with the content in Google's databases.

"A canonical URL is the URL of the page that Google thinks is most representative from a set of duplicate pages on your site. For example, if you have URLs for the same page (for example: and, Google chooses one as canonical." (Source: Consolidate duplicate URLs)

The following are the requirements for the canonical URL:

  • url must be globally unique.
  • url must contain a working canonical URL that Google can crawl.
  • (Listen Actions only) url needs to point to a content description page that is not blocked by a paywall.

Collect the ID, URL, and name

Do the following:

  1. Gather the names of the content in your catalog.
  2. Identify the canonical URLs of the content. (We recommend you use the content's url as its @id.)