Content markup properties of clips

This section provides the details of the content markup properties for the Preview, Recap, Review, Highlight, Blooper, BehindTheScene, DeletedScene, and Interview clip types.

Preview specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}].
  • xx represents the language of the strings in the feed. Each root entity context should have its @language set to the appropriate language code in BCP 47 format. For example, if the language is set to Spanish, the values for name and description are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to Preview.
@id URL Required - The preview's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
name Text Required - The name of the preview clip.
description Text Required - A description of the preview, limited to 300 characters.
potentialAction WatchAction Required - An Action markup object that provides the details of the action.
mainEntity.@type Text Required - Use the mainEntity property to represent the entity that this preview belongs to.

This property can have the following values:
The mainEntity property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these mainEntity types to include Deep links, as conveyed through the potentialAction property.
mainEntity.@id URL Required - The @id of the corresponding entity. The entity must exist in the feed and have an @id that's different from the Preview @id.

Preview example

The following example shows the markup for a Preview clip on the left tab and its linked mainEntity on the right tab. This example doesn't include a deep link on the mainEntity type.

Preview

The following clip represents a preview of a sports event. The sports event is specified by the @type and @id of the mainEntity property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Preview"
  "@id": "https://www.example.com/preview_clip/teama-teamb",
  "name": "A preview for Team A vs Team B"
  "description": "An analysis of two teams, Team A and Team B, before their game."
  "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/premium/teama_vs_teamb_pregame",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-09T10:00:00Z",
        "availabilityEnds": "2019-09-31T10:00:00Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "@id": "http://www.example.com/premium_subscription",
          "name": "Example Premium",
          "sameAs": "http://www.example.com/premium_subscription"
        },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  "mainEntity": {
    "@type": "SportsEvent",
    "@id": "https://www.example.com/game/2019-09-12/teama-teamb"
  }
}

SportsEvent

The following is the mainEntity associated with the clip specified in the Preview clip. This entity doesn't include a deep link. If you have deep links, you can add them with the potentialAction property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "https://www.example.com/game/2019-09-12/teama-teamb",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

Recap specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}].
  • xx represents the language of the strings in the feed. Each root entity context should have its @language set to the appropriate language code in BCP 47 format. For example, if the language is set to Spanish, the values for name and description are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to Recap.
@id URL Required - The recap's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
name Text Required - The name of the recap clip.
description Text Required - A description of the recap, limited to 300 characters.
potentialAction WatchAction Required - An Action markup object that provides the details of the action.
mainEntity.@type Text Required - Use the mainEntity property to represent the entity that this recap belongs to.

This property can have the following values:
The mainEntity property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these mainEntity types to include Deep links, as conveyed through the potentialAction property.
mainEntity.@id URL Required - The @id of the corresponding entity. The entity must exist in the feed and have an @id that's different from the Recap @id.

Recap example

The following example shows the markup for a Recap clip on the left tab and its linked mainEntity on the right tab. This example doesn't include a deep link on the mainEntity type.

Recap

The following clip represents a recap of a sports event. The sports event is specified by the @type and @id of the mainEntity property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Recap"
  "@id": "https://www.example.com/recap_clip/teama-teamb",
  "name": "A recap for Team A vs Team B"
  "description": "An analysis of two teams, Team A and Team B, after their game."
  "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/premium/teama_vs_teamb_recap",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-09T10:00:00Z",
        "availabilityEnds": "2019-09-31T10:00:00Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "@id": "http://www.example.com/premium_subscription",
          "name": "Example Premium",
          "sameAs": "http://www.example.com/premium_subscription"
        },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  "mainEntity": {
    "@type": "SportsEvent",
    "@id": "https://www.example.com/game/2019-09-12/teama-teamb"
  }
}

SportsEvent

The following is the mainEntity associated with the clip specified in the Recap clip. This entity doesn't include a deep link. If you have deep links, you can add them with the potentialAction property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "https://www.example.com/game/2019-09-12/teama-teamb",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

Review specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}].
  • xx represents the language of the strings in the feed. Each root entity context should have its @language set to the appropriate language code in BCP 47 format. For example, if the language is set to Spanish, the values for name and description are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to Review.
@id URL Required - The review's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
name Text Required - The name of the review clip.
description Text Required - A description of the review, limited to 300 characters.
potentialAction WatchAction Required - An Action markup object that provides the details of the action.
mainEntity.@type Text Required - Use the mainEntity property to represent the entity that this review belongs to.

This property can have the following values:
The mainEntity property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these mainEntity types to include Deep links, as conveyed through the potentialAction property.
mainEntity.@id URL Required - The @id of the corresponding entity. The entity must exist in the feed and have an @id that's different from the Review @id.

Review example

The following example shows the markup for a Review clip on the left tab and its linked mainEntity on the right tab. This example includes a deep link.

Review

The following clip represents a review of a movie. The movie is specified by the @type and @id of the mainEntity property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Review"
  "@id": "https://www.example.com/review_clip/abc",
  "name": "A review of ABC"
  "description": "A no-spoiler review of the Sci-Fi Movie, ABC."
  "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://www.example.com/review_clip/abc",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-09T10:00:00Z",
        "availabilityEnds": "2019-09-31T10:00:00Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "@id": "http://www.example.com/premium_subscription",
          "name": "Example Premium",
          "sameAs": "http://www.example.com/premium_subscription"
        },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  "mainEntity": {
    "@type": "Movie",
    "@id": "https://www.example.com/movie/abc"
  }
}

Movie

The following is the mainEntity associated with the clip specified in the Review clip. This entity includes deep links in its potentialAction property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "https://www.example.com/movie/abc",
  "url": "https://www.example.com/movie/abc",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "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"
    }
  ]
}

Highlight specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}].
  • xx represents the language of the strings in the feed. Each root entity context should have its @language set to the appropriate language code in BCP 47 format. For example, if the language is set to Spanish, the values for name and description are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to Highlight.
@id URL Required - The highlight's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
name Text Required - The name of the highlight clip.
description Text Required - A description of the highlight, limited to 300 characters.
potentialAction WatchAction Required - An Action markup object that provides the details of the action.
mainEntity.@type Text Required - Use the mainEntity property to represent the entity that this highlight belongs to.

This property can have the following values:
The mainEntity property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these mainEntity types to include Deep links, as conveyed through the potentialAction property.
mainEntity.@id URL Required - The @id of the corresponding entity. The entity must exist in the feed and have an @id that's different from the Highlight @id.

Highlight example

The following example shows the markup for a Highlight clip on the left tab and its linked mainEntity on the right tab. This example doesn't include a deep link on the mainEntity type.

Highlight

The following clip represents a highlight from a sports event. The sports event is specified by the @type and @id of the mainEntity property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Highlight"
  "@id": "https://www.example.com/highlight_clip/teama-teamb",
  "name": "Highlight for the Team A vs Team B game"
  "description": "Highlight for the Team A vs Team B game."
  "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/premium/teama_vs_teamb_highlight",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-09T10:00:00Z",
        "availabilityEnds": "2019-09-31T10:00:00Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "@id": "http://www.example.com/premium_subscription",
          "name": "Example Premium",
          "sameAs": "http://www.example.com/premium_subscription"
        },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  "mainEntity": {
    "@type": "SportsEvent",
    "@id": "https://www.example.com/game/2019-09-12/teama-teamb"
  }
}

SportsEvent

The following is the mainEntity associated with the clip specified in the Highlight clip. This entity doesn't include a deep link. If you have deep links, you can add them with the potentialAction property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "https://www.example.com/game/2019-09-12/teama-teamb",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

Blooper specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}].
  • xx represents the language of the strings in the feed. Each root entity context should have its @language set to the appropriate language code in BCP 47 format. For example, if the language is set to Spanish, the values for name and description are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to Blooper.
@id URL Required - The blooper's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
name Text Required - The name of the blooper clip.
description Text Required - A description of the blooper, limited to 300 characters.
potentialAction WatchAction Required - An Action markup object that provides the details of the action.
mainEntity.@type Text Required - Use the mainEntity property to represent the entity that this blooper clip belongs to.

This property can have the following values:
The mainEntity property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these mainEntity types to include Deep links, as conveyed through the potentialAction property.
mainEntity.@id URL Required - The @id of the corresponding entity. The entity must exist in the feed and have an @id that's different from the Blooper @id.

Blooper example

The following example shows the markup for a Blooper clip on the left tab and its linked mainEntity on the right tab. This example includes a deep link.

Blooper

The following clip represents a blooper from a movie. The movie is specified by the @type and @id of the mainEntity property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Blooper"
  "@id": "https://www.example.com/blooper_abc",
  "name": "ABC Bloopers"
  "description": "Bloopers during the filming of ABC"
  "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://www.example.com/blooper_abc",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-09T10:00:00Z",
        "availabilityEnds": "2019-09-31T10:00:00Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "@id": "http://www.example.com/premium_subscription",
          "name": "Example Premium",
          "sameAs": "http://www.example.com/premium_subscription"
        },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  "mainEntity": {
    "@type": "Movie",
    "@id": "https://www.example.com/movie/abc"
  }
}

Movie

The following is the mainEntity associated with the clip specified in the Blooper clip. This entity includes deep links in its potentialAction property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "https://www.example.com/movie/abc",
  "url": "https://www.example.com/movie/abc",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "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"
    }
  ]
}

BehindTheScene specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}].
  • xx represents the language of the strings in the feed. Each root entity context should have its @language set to the appropriate language code in BCP 47 format. For example, if the language is set to Spanish, the values for name and description are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to BehindTheScene.
@id URL Required - The clip's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
name Text Required - The name of the behind-the-scene clip.
description Text Required - A description of the behind-the-scene clip, limited to 300 characters.
potentialAction WatchAction Required - An Action markup object that provides the details of the action.
mainEntity.@type Text Required - Use the mainEntity property to represent the entity that this behind-the-scene clip belongs to.

This property can have the following values:
The mainEntity property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these mainEntity types to include Deep links, as conveyed through the potentialAction property.
mainEntity.@id URL Required - The @id of the corresponding entity. The entity must exist in the feed and have an @id that's different from the BehindTheScene @id.

BehindTheScene example

The following example shows the markup for a BehindTheScene clip on the left tab and its linked mainEntity on the right tab. This example includes a deep link.

BehindTheScene

The following represents a behind-the-scene clip from a movie. The movie is specified by the @type and @id of the mainEntity property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BehindTheScene"
  "@id": "https://www.example.com/behind_the_scene_abc",
  "name": "ABC Behind the scene"
  "description": "Behind the scene of ABC."
  "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://www.example.com/behind_the_scene_abc",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-09T10:00:00Z",
        "availabilityEnds": "2019-09-31T10:00:00Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "@id": "http://www.example.com/premium_subscription",
          "name": "Example Premium",
          "sameAs": "http://www.example.com/premium_subscription"
        },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  "mainEntity": {
    "@type": "Movie",
    "@id": "https://www.example.com/movie/abc"
  }
}

Movie

The following is the mainEntity associated with the clip specified in the BehindTheScene clip. This entity includes deep links in its potentialAction property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "https://www.example.com/movie/abc",
  "url": "https://www.example.com/movie/abc",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "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"
    }
  ]
}

DeletedScene specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}].
  • xx represents the language of the strings in the feed. Each root entity context should have its @language set to the appropriate language code in BCP 47 format. For example, if the language is set to Spanish, the values for name and description are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to DeletedScene.
@id URL Required - The clip's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
name Text Required - The name of the deleted scene.
description Text Required - A description of the deleted scene, limited to 300 characters.
potentialAction WatchAction Required - An Action markup object that provides the details of the action.
mainEntity.@type Text Required - Use the mainEntity property to represent the entity that this deleted scene belongs to.

This property can have the following values:
The mainEntity property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these mainEntity types to include Deep links, as conveyed through the potentialAction property.
mainEntity.@id URL Required - The @id of the corresponding entity. The entity must exist in the feed and have an @id that's different from the DeletedScene @id.

DeletedScene example

The following example shows the markup for a DeletedScene clip on the left tab and its linked mainEntity on the right tab. This example includes a deep link.

DeletedScene

The following clip represents a deleted scene from a movie. The movie is specified by the @type and @id of the mainEntity property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "DeletedScene"
  "@id": "https://www.example.com/deleted_scene_abc",
  "name": "Deleted Sscenes in ABC"
  "description": "Deleted Sscenes in ABC."
  "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://www.example.com/deleted_scene_abc",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-09T10:00:00Z",
        "availabilityEnds": "2019-09-31T10:00:00Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "@id": "http://www.example.com/premium_subscription",
          "name": "Example Premium",
          "sameAs": "http://www.example.com/premium_subscription"
        },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  "mainEntity": {
    "@type": "Movie",
    "@id": "https://www.example.com/movie/abc"
  }
}

Movie

The following is the mainEntity associated with the clip specified in the DeletedScene clip. This entity includes deep links in its potentialAction property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "https://www.example.com/movie/abc",
  "url": "https://www.example.com/movie/abc",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "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"
    }
  ]
}

Interview specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}].
  • xx represents the language of the strings in the feed. Each root entity context should have its @language set to the appropriate language code in BCP 47 format. For example, if the language is set to Spanish, the values for name and description are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to Interview.
@id URL Required - The interview's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
name Text Required - The name of the interview clip.
description Text Required - A description of the interview, limited to 300 characters.
potentialAction WatchAction Required - An Action markup object that provides the details of the action.
mainEntity.@type Text Required - Use the mainEntity property to represent the entity that this interview belongs to.

This property can have the following values:
The mainEntity property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these mainEntity types to include Deep links, as conveyed through the potentialAction property.
mainEntity.@id URL Required - The @id of the corresponding entity. The entity must exist in the feed and have an @id that's different from the Interview @id.
interviewer.@type Text Required - Always set to Person.
interviewer.@id URL Required - The interviewer's identifier in URI format; for example, https://example.com/person/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
interviewer.name Text Required - The name of the interviewer.
interviewee.@type Text Required - Always set to Person.
interviewee.@id URL Required - The interviewee's identifier in URI format; for example, https://example.com/person/1234abc.
@id must meet the following requirements:
  • It's globally unique across your catalog.
  • It's static. The ID must be stable and not change over time.
  • It's in the form of a Unified Resource Identifier (URI).
  • The domain used for the @id value must be owned by your organization.
interviewee.name Text Required - The name of the interviewee.

Interview example

The following example shows the markup for a Interview clip on the left tab and its linked mainEntity on the right tab. This example includes a deep link.

Interview

The following clip represents an interview about a movie. The movie is specified by the @type and @id of the mainEntity property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Interview"
  "@id": "https://www.example.com/abc_personb_interview",
  "name": "ABC Promotional Interview"
  "description": "ABC promotional interview ofwith Person B with host Person A."
  "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://www.example.com/abc_personb_interview",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-09T10:00:00Z",
        "availabilityEnds": "2019-09-31T10:00:00Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "@id": "http://www.example.com/premium_subscription",
          "name": "Example Premium",
          "sameAs": "http://www.example.com/premium_subscription"
        },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  "mainEntity": {
    "@type": "Movie",
    "@id": "https://www.example.com/movie/abc"
  }
  "interviewer": {
    "@type": "Person"
    "@id": "https://example.com/person/1234abc"
    "name": "Person A"
  }
  "interviewee": {
    "@type": "Person"
    "@id": "https://example.com/person/45664abc"
    "name" : "Person B"
  }
}

Movie

The following is the mainEntity associated with the clip specified in the Interview clip. This entity includes deep links in its potentialAction property.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "https://www.example.com/movie/abc",
  "url": "https://www.example.com/movie/abc",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "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"
    }
  ]
}