# Podcast

Source: https://docs.bearletter.com/blog/podcast

The podcast is part of the blog folder, with Pro: `podcast.md` for the show and `podcast/<name>.md` for each episode. Episodes are written, previewed and published in Write like posts. An episode's name is also its address: `podcast/first-words.md` is `/podcast/first-words`. Names use letters, digits, `_` and `-`.

The show's page is `/podcast`, its feed (for Apple Podcasts, Spotify and every podcast app) `/podcast.xml`.

## `podcast.md`

| Property | Value |
| --- | --- |
| `title` | Required. The show's name, up to 200 characters. |
| `author` | Who makes it. |
| `owner_email` | The address podcast directories may contact. |
| `cover` | The cover image's address: a square JPEG or PNG, 1400 to 3000 pixels, as Apple Podcasts and Spotify ask. |
| `category` | An Apple Podcasts category, such as `Arts` or `Arts > Books`. |
| `explicit` | `true` or `false`. |
| `language` | A code such as `en` or `zh-CN`. |
| `type` | `episodic` (newest first) or `serial` (in order). |
| `copyright` | Up to 300 characters. |
| `apple_url`, `spotify_url` | The show's pages there, shown as listen links. |
| `new_feed_url` | Where the show moved, when it leaves Bearletter. |

The body is the show's description.

## `podcast/<name>.md`

| Property | Value |
| --- | --- |
| `title` | Required. Up to 300 characters. |
| `audio` | Required to publish: the MP3 or M4A file's address in your media library. |
| `duration` | `42:10`, `1:02:15` or a number of seconds. |
| `episode`, `season` | Numbers from 1. |
| `episode_type` | `full`, `trailer` or `bonus`. |
| `explicit` | `true` or `false`. |
| `image` | The episode's own cover. |
| `transcript` | A VTT or SRT file from your media library. |
| `guid` | Kept from another host when the show moved here, so apps do not show episodes twice. |
| `published_date` | `2026-10-02` or `2026-10-02 09:30`, in the blog's time zone. A future date schedules it. |
| `publish` | `false` keeps it a draft. |
| `meta_description` | The summary in apps and search. Without it, the first paragraph is used. |

The body is the show notes.

## Listing episodes on the blog

Put `::podcast` (or `::podcast{limit="5"}`) in `home.md` or a page to list the latest episodes. See [Components](/blog/components).
