---
title: "TV Series Schema"
description: "Use defineTVSeries() to describe a TV show, including its cast, creator, ratings, seasons, episodes, dates, and trailer."
canonical_url: "https://unhead.unjs.io/docs/schema-org/api/schema/tv-series"
last_updated: "2026-08-11T00:43:40.145Z"
---

## Schema.org TVSeries

**Type**: `defineTVSeries<T extends Record<string, any>>(input?: TVSeries & T)`

Describes a TV series.

## Useful Links

- [TVSeries - Schema.org](https://schema.org/TVSeries)
- [Video Structured Data - Google Search Central](https://developers.google.com/search/docs/appearance/structured-data/video)

TVSeries is a general Schema.org type, not Google's VideoObject result type. A nested trailer must meet Google's VideoObject requirements independently.

## Required properties

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

The name of the TV series.

## Recommended Properties

- **actor** `NodeRelations<Person | string>`<br />

An array of actors in the series, resolved as [Person](/docs/schema-org/api/schema/person) nodes.
- **director** `NodeRelations<Person | string>`<br />

An array of directors of the series, resolved as [Person](/docs/schema-org/api/schema/person) nodes.
- **creator** `NodeRelations<Person | Organization | string>`<br />

The creator of the series. Plain objects and strings resolve as [Person](/docs/schema-org/api/schema/person); wrap an organization with `defineOrganization()` to select the Organization resolver.
- **numberOfSeasons** `number`<br />

The total number of seasons.
- **numberOfEpisodes** `number`<br />

The total number of episodes.

## Defaults

- **@type**: `TVSeries`
- **@id**: `${canonicalUrl}#/schema/tv-series/{n}`

## Examples

### Minimal

```ts
defineTVSeries({
  name: 'Breaking Bad',
})
```

### Detailed example

```ts
defineTVSeries({
  name: 'Breaking Bad',
  description: 'A chemistry teacher diagnosed with cancer turns to manufacturing meth',
  url: 'https://example.com/shows/breaking-bad',
  image: 'https://example.com/shows/breaking-bad-poster.jpg',
  numberOfSeasons: 5,
  numberOfEpisodes: 62,
  genre: ['Crime', 'Drama', 'Thriller'],
  actor: [
    { name: 'Bryan Cranston' },
    { name: 'Aaron Paul' },
  ],
  director: [
    { name: 'Vince Gilligan' },
  ],
  creator: {
    name: 'Vince Gilligan',
  },
  productionCompany: {
    name: 'AMC Studios',
  },
  datePublished: new Date(2008, 0, 20),
  aggregateRating: {
    ratingValue: 9.5,
    ratingCount: 1500000,
  },
})
```

## Types

```ts
export interface TVSeriesSimple extends Thing {
  name: string
  description?: string
  url?: string
  image?: NodeRelations<string | ImageObject>
  actor?: NodeRelations<Person | string>
  director?: NodeRelations<Person | string>
  creator?: NodeRelations<Person | Organization | string>
  numberOfSeasons?: number
  numberOfEpisodes?: number
  containsSeason?: NodeRelations<any>
  episode?: NodeRelations<any>
  genre?: string | string[]
  datePublished?: ResolvableDate
  startDate?: ResolvableDate
  endDate?: ResolvableDate
  productionCompany?: NodeRelation<Organization | string>
  aggregateRating?: NodeRelation<AggregateRating>
  countryOfOrigin?: string
  trailer?: NodeRelation<VideoObject | string>
  contentRating?: string
}
```