---
title: Podcast Episode Schema
description: Use definePodcastEpisode() to describe a podcast episode, including its title, audio, dates, duration, transcript, and parent series.
---

## Schema.org PodcastEpisode

**Type**: `definePodcastEpisode<T extends Record<string, any>>(input?: PodcastEpisode & T)`{lang="ts"}

  Describes an individual podcast episode.

## Useful Links

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

## Required properties

- **name** `string`

  The name/title of the podcast episode.

## Recommended properties

- **url** `string`

  The URL of the episode page.

- **audio** `string`

  The URL of the audio file for the episode.

- **description** `string`

  A description of the episode.

- **duration** `string`

  The duration of the episode in ISO 8601 format (e.g., "PT45M" for 45 minutes).

- **datePublished** `ResolvableDate`

  The date the episode was published.

- **partOfSeries** `NodeRelation<any>`

  Reference to the podcast series this episode belongs to. Use `definePodcastSeries()` for a nested object if you want Unhead to attach the `PodcastSeries` resolver.

## Defaults

- **@type**: `PodcastEpisode`
- **@id**: `${canonicalUrl}#/schema/podcast-episode/{n}`
- **inLanguage**: `inLanguage` from resolved page metadata _(see: [Schema.org Params](/docs/schema-org/guides/core-concepts/params))_

## Examples

### Minimal

```ts
definePodcastEpisode({
  name: 'Episode 1: Getting Started',
  url: 'https://example.com/podcast/episode-1',
  audio: 'https://example.com/podcast/ep1.mp3',
})
```

### Detailed example

```ts
definePodcastEpisode({
  name: 'Episode 42: The Answer to Everything',
  description: 'In this episode, we explore the meaning of life, the universe, and everything.',
  url: 'https://example.com/podcast/episode-42',
  audio: 'https://example.com/podcast/ep42.mp3',
  episodeNumber: 42,
  duration: 'PT45M30S', // 45 minutes 30 seconds
  datePublished: new Date(2024, 5, 15),
  image: 'https://example.com/episode-42-cover.jpg',
  transcript: 'https://example.com/podcast/ep42-transcript',
  partOfSeries: definePodcastSeries({
    name: 'The Example Podcast',
  }),
  author: {
    name: 'Jane Doe',
  },
})
```

## Types

```ts
export interface PodcastEpisodeSimple extends Thing {
  name: string
  description?: string
  url?: string
  episodeNumber?: number | string
  partOfSeries?: NodeRelation<any>
  partOfSeason?: NodeRelation<any>
  author?: NodeRelations<Person | Organization | string>
  audio?: NodeRelation<any | string>
  duration?: string
  image?: NodeRelations<string | ImageObject>
  thumbnailUrl?: string
  datePublished?: ResolvableDate
  uploadDate?: ResolvableDate
  transcript?: string
  inLanguage?: string
  aggregateRating?: NodeRelation<AggregateRating>
  review?: NodeRelations<Review>
  keywords?: Arrayable<string>
}
```

## Related Schemas

- [PodcastSeries](/docs/schema-org/api/schema/podcast-series): Parent series
- [Person](/docs/schema-org/api/schema/person): Host, guests