XooCode(){

TVSeason

TVSeason is a CreativeWorkSeason subtype for a single season of a TV show. It adds just two direct properties on top of the inherited CreativeWorkSeason vocabulary: countryOfOrigin (Country) and titleEIDR (the EIDR identifier at season level).

Use CreativeWorkSeason properties for the meat: seasonNumber, numberOfEpisodes, partOfSeries, episode, actor, director, trailer.

Full example of schema.org/TVSeason json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional
schema.org/TVSeason
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TVSeason",
  "name": "Crawlers - Season 3",
  "seasonNumber": 3,
  "numberOfEpisodes": 10,
  "startDate": "2024-09-15",
  "endDate": "2024-11-24",
  "countryOfOrigin": { "@type": "Country", "name": "United States" },
  "titleEIDR": "10.5240/7B9A-8C3D-1E2F-4A5B-6C7D-E",
  "partOfSeries": { "@type": "TVSeries", "name": "Crawlers" },
  "productionCompany": { "@type": "Organization", "name": "Xoo Code Studios" },
  "trailer": { "@type": "VideoObject", "name": "Crawlers S3 trailer", "contentUrl": "https://xoocode.com/crawlers/s3/trailer.mp4", "uploadDate": "2024-08-01", "duration": "PT1M38S" }
}
</script>

Minimal valid version

The smallest markup that still produces a valid TVSeason entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/TVSeason (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TVSeason",
  "seasonNumber": 3,
  "numberOfEpisodes": 10,
  "partOfSeries": { "@type": "TVSeries", "name": "Crawlers" }
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

Common TVSeason mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    TVSeason without partOfSeries

    Wrong
    TVSeason floating without a series reference
    Right
    Always populate partOfSeries to the TVSeries

    A season without its show is meaningless. Season-level watch pages rely on partOfSeries to navigate up to the series landing page.

Schema properties in this example

TVSeasonCreativeWorkSeasonnameseasonNumbernumberOfEpisodesstartDateendDatecountryOfOriginCountrytitleEIDRpartOfSeriesTVSeriesproductionCompanyOrganizationtrailerVideoObjectcontentUrluploadDateduration

About the example data

Season 3 of Crawlers (2024), 10 episodes, shot on location in Dunmore and Scranton.

Comments

Loading comments...

Leave a comment