numberOfSeasons

numberOfSeasons · Not mentioned by Google

Appears in

• TVSeries

What is it?

numberOfSeasons is an integer that records the total number of seasons in a television series. It gives search engines and AI systems a single number to report when users ask how long a show ran or how many seasons are available to stream.

Why this matters for AEO

When a user asks "how many seasons does Breaking Bad have?" an AI answer engine pulls numberOfSeasons directly from the TVSeries entity to return a definitive count. Without this field, the engine must parse episode lists or Wikipedia text to calculate the answer, increasing the chance of an inaccurate response.

What the specs say

Schema.org: Integer. The number of seasons in this series. schema.org/numberOfSeasons

Google: Not mentioned. No dedicated Google structured data page exists for TVSeries. Google does not document rich result support for this property.

How to find your value

• IMDb — Series main page, listed under "Seasons"
• TMDb — Series detail page, season count in sidebar
• Wikipedia — Series infobox, "No. of seasons" row
• Streaming platform — Season selector dropdown on the show page

Count only released seasons. Do not include announced or upcoming seasons unless episodes have aired.

Format and code

Type: Integer (whole number, no decimals, no quotes around the value)

{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "Breaking Bad",
  "numberOfSeasons": 5
}

Valid values:

• 5 — Yes
• "5" — No
• 5.0 — No
• 0 — Technically valid

Webflow implementation

Static pages

Add the full JSON-LD block in Page Settings > Custom Code > Footer Code for any static page about a TV series:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "Breaking Bad",
  "numberOfSeasons": 5,
  "numberOfEpisodes": 62
}
</script>

CMS template pages

Create a Number field in your CMS collection (e.g., seasons-count). Reference it in your embed code on the template page:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "{{wf {"path":"name","type":"PlainText"} }}",
  "numberOfSeasons": {{wf {"path":"seasons-count","type":"PlainText"} }}
}
</script>

In Schema HQ

Field mapping pulls CMS number field to numberOfSeasons and outputs it as a proper integer in the published JSON-LD. No manual embed code needed.

Real examples

SwiftSchema (source):

{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "SwiftSchema Stories",
  "numberOfSeasons": 2,
  "numberOfEpisodes": 18
}

Schema.org example (source):

{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "Grey's Anatomy",
  "containsSeason": [
    {
      "@type": "TVSeason",
      "name": "Season 1",
      "numberOfEpisodes": 14
    },
    {
      "@type": "TVSeason",
      "name": "Season 2",
      "numberOfEpisodes": 27
    }
  ]
}

Note: the Schema.org example uses containsSeason with individual season objects rather than a top-level numberOfSeasons count. Both approaches are valid. Using numberOfSeasons at the series level alongside containsSeason for detail gives AI engines both the summary and the breakdown.

Related fields

• numberOfEpisodes — total episode count for the series or season
• name — title of the series
• description — synopsis of the series

FAQ

Can numberOfSeasons include specials or miniseries?

Only count distinct numbered seasons. Specials, bonus episodes, or reunion episodes that fall outside the standard season numbering should not inflate the count.

Should numberOfSeasons update when a new season airs?

Yes. Update the value each time a new season begins airing. If a series is in production for season 6, keep the value at 5 until the first episode of season 6 airs.