episodeNumber

episodeNumber · No Google docs page

Appears in

TVEpisode

What is it?

The episodeNumber property specifies the sequential position of an episode within its season or series. It tells search engines and media catalogs exactly which episode in the order this entry represents.

Why this matters for AEO

When a user asks "what episode of The Last of Us does Joel meet Ellie," AI answer engines use episodeNumber combined with partOfSeason to pinpoint the exact episode. Numeric episode data lets the AI provide a precise "Season 1, Episode 1" answer.

What the specs say

Schema.org:Integer, Text. Position of the episode within an ordered group of episodes.

Google: No dedicated Google structured data page exists for TVEpisode.

How to find your value

• Streaming platforms — Episode number on detail page
• TV databases — IMDb, TVDB episode listings
• Network schedules — Episode numbering in EPG
• Production codes — Official episode order

Format and code

{
  "@context": "https://schema.org",
  "@type": "TVEpisode",
  "name": "When You're Lost in the Darkness",
  "episodeNumber": "1",
  "partOfSeason": {
    "@type": "TVSeason",
    "seasonNumber": "1"
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "name": "The Last of Us"
  }
}

As an integer (preferred for machine processing):

{
  "episodeNumber": 1
}

Nested within a series structure:

{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "Grey's Anatomy",
  "containsSeason": {
    "@type": "TVSeason",
    "name": "Season 2",
    "episode": {
      "@type": "TVEpisode",
      "name": "Episode 1",
      "episodeNumber": "1"
    }
  }
}

Webflow implementation

Static pages

Add episodeNumber as a number or string inside your TVEpisode JSON-LD block in Page Settings > Custom Code > Footer Code.

CMS template pages

Create a CMS number field for episode number. Reference it in a custom code embed. Ensure it outputs as a plain integer.

In Schema HQ

The episodeNumber field does not currently generate TVEpisode markup. Add episode number data manually through Webflow custom code.

Real examples

From Schema.org TVEpisode Example:

{
  "@context": "https://schema.org",
  "@type": "TVSeries",
  "name": "Greys Anatomy",
  "containsSeason": {
    "@type": "TVSeason",
    "name": "Season 2",
    "episode": {
      "@type": "TVEpisode",
      "name": "Episode 1",
      "episodeNumber": "1"
    }
  }
}

From Playwire Entertainment SEO Guide:

{
  "@context": "https://schema.org",
  "@type": "TVEpisode",
  "name": "Episode Title",
  "episodeNumber": "1",
  "partOfSeason": {
    "@type": "TVSeason",
    "seasonNumber": "2"
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "name": "The Last of Us"
  }
}

Related fields

• partOfSeason
• partOfSeries
• name

FAQ

Should episodeNumber be an integer or a string?

Schema.org accepts both. Integers are preferred for machine processing. Most implementations use string values ("1") and parsers handle them without issue.

Does episodeNumber refer to position within the season or the series?

Within the season. Episode 1 of Season 3 is episodeNumber: "1", not the cumulative count across all seasons. Use partOfSeason to provide the season context.

What if episodes are not numbered (e.g., specials)?

Use Text values for non-standard numbering: "S1" for special 1, or a descriptive identifier. For numbered specials, use the production episode number.