---
title: "TV Season Schema"
description: "Use defineTVSeason() to add TVSeason structured data. Organize TV episodes by season with episode counts, cast, and air dates."
canonical_url: "https://unhead.unjs.io/docs/schema-org/api/schema/tv-season"
last_updated: "2026-06-30T06:57:26.049Z"
---

## Schema.org TVSeason

**Type**: `defineTVSeason(input?: TVSeason)`

Describes a season of a TV series.

## Useful Links

- [TVSeason - Schema.org](https://schema.org/TVSeason)

## Recommended Properties

- **name** `string`<br />

The name of the season.
- **seasonNumber** `number`<br />

The season number.
- **partOfSeries** `NodeRelation<TVSeries>`<br />

Reference to the TV series this season belongs to.
- **numberOfEpisodes** `number`<br />

The number of episodes in the season.

## Defaults

- **@type**: `TVSeason`

## Examples

### Minimal

```ts
defineTVSeason({
  seasonNumber: 2,
  partOfSeries: {
    name: 'Breaking Bad',
  },
})
```

### Complete

```ts
defineTVSeason({
  name: 'Season 2',
  seasonNumber: 2,
  description: 'The second season of Breaking Bad',
  numberOfEpisodes: 13,
  partOfSeries: {
    name: 'Breaking Bad',
  },
  image: 'https://example.com/shows/breaking-bad-season-2.jpg',
  datePublished: new Date(2009, 2, 8),
  startDate: new Date(2009, 2, 8),
  endDate: new Date(2009, 4, 31),
})
```

## Types

```ts
export interface TVSeasonSimple extends Thing {
  name?: string
  description?: string
  seasonNumber?: number
  numberOfEpisodes?: number
  partOfSeries?: NodeRelation<any>
  episode?: NodeRelations<any>
  datePublished?: ResolvableDate
  startDate?: ResolvableDate
  endDate?: ResolvableDate
  image?: NodeRelations<string | ImageObject>
  url?: string
  actor?: NodeRelations<Person | string>
  director?: NodeRelations<Person | string>
  productionCompany?: NodeRelation<Organization | string>
  aggregateRating?: NodeRelation<AggregateRating>
  contentRating?: string
  trailer?: NodeRelation<VideoObject | string>
}
```

## Related Schemas

- [TVEpisode](/docs/schema-org/api/schema/tv-episode) - Season episodes
- [Person](/docs/schema-org/api/schema/person) - Director, actors
- [Organization](/docs/schema-org/api/schema/organization) - Production company