numberOfEpisodes

numberOfEpisodes · Not mentioned by Google

Appears in

• TVSeries

What is it?

numberOfEpisodes is an integer that records the total number of episodes in a television series or a single season. It appears on both TVSeries (total across all seasons) and TVSeason (episodes within that season), giving search engines a precise count at whichever level of detail the markup provides.

Why this matters for AEO

When a user asks "how many episodes of Stranger Things are there?" an AI answer engine looks for numberOfEpisodes on the TVSeries entity. If the markup includes per-season episode counts inside containsSeason, the engine can also answer "how many episodes are in season 3?" without scraping episode guides.

What the specs say

Schema.org: Integer. The number of episodes in this season or series. Domain includes CreativeWorkSeason, RadioSeries, TVSeries, and VideoGameSeries. schema.org/numberOfEpisodes

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 or season page, episode list count
• TMDb — Season detail page, episode count
• Wikipedia — Series infobox, "No. of episodes" row
• Streaming platform — Episode list on the show or season page

For series-level counts, total all episodes across all aired seasons. For season-level counts, count only episodes within that season.

Format and code

Type: Integer (whole number)

At the series level:

{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "Stranger Things",
  "numberOfSeasons": 4,
  "numberOfEpisodes": 34
}

At the season level (inside containsSeason):

{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "Stranger Things",
  "containsSeason": [
    {
      "@type": "TVSeason",
      "seasonNumber": 1,
      "numberOfEpisodes": 8
    },
    {
      "@type": "TVSeason",
      "seasonNumber": 2,
      "numberOfEpisodes": 9
    }
  ]
}

Valid values:

• 34 — Yes
• "34" — No
• 8 — Yes

Webflow implementation

Static pages

Add the JSON-LD block in Page Settings > Custom Code > Footer Code:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "Stranger Things",
  "numberOfSeasons": 4,
  "numberOfEpisodes": 34
}
</script>

CMS template pages

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

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

In Schema HQ

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

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,
      "datePublished": "2005-05-22"
    },
    {
      "@type": "TVSeason",
      "name": "Season 2",
      "numberOfEpisodes": 27,
      "datePublished": "2006-05-14"
    }
  ]
}

Related fields

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

FAQ

Should numberOfEpisodes at the series level match the sum of all season-level counts?

Yes. If you include both a top-level numberOfEpisodes and per-season counts inside containsSeason, the top-level number should equal the total of all season counts. Inconsistencies confuse AI engines and validators.

Does numberOfEpisodes include specials or bonus episodes?

Only count episodes that are part of the official season numbering. Specials, behind-the-scenes features, or recap episodes that fall outside the numbered episode list should be excluded unless the source (IMDb, TMDb) includes them in the official count.