Media (podcasts)
Podcast episodes power the Media hub at /media. Each episode has its own page at /media/[slug] with optional YouTube embed, audio player, transcript, and research cross-links.
Admin path
/admin/podcasts → New episode → /admin/podcasts/new
Fields
| Field | Purpose |
|---|---|
| Title / Slug | Episode name and URL |
| Description | Summary and default teaser |
| Visibility / Teaser | See Access & gating |
| YouTube URL | Full or youtu.be link for video embed |
| Audio URL | MP3 or podcast feed episode URL |
| Episode # | Display number |
| Duration (seconds) | e.g. 3600 for 1 hour |
| Publish date | Shown on episode page |
| Featured image URL | Thumbnail when no YouTube video |
| Tags | Comma-separated topics |
| Research links | JSON linking frameworks or studies |
| Transcript | Full plain-text transcript |
| Feature on Media hub | Hero episode on /media |
| Published | Live on public site |
Video vs audio
- YouTube URL — primary embed on episode page when set
- Audio URL — fallback or standalone audio player
- At least one of YouTube or Audio is recommended
Research links JSON
Connect episodes to site research content:
[
{
"type": "framework",
"slug": "cognitive-agency",
"note": "Episode theme"
},
{
"type": "study",
"slug": "purposeful-friction-pilot",
"note": "Related pilot study"
}
]
| Field | Values |
|---|---|
type |
"framework" or "study" |
slug |
Public slug of the linked item |
note |
Optional display note |
Use framework slugs from /research/[slug] and study slugs from /studies/[slug].
Step-by-step: publish an episode
/admin/podcasts/new- Title, description, YouTube and/or audio URL
- Episode number, duration, publish date
- Add tags and optional research links JSON
- Paste transcript if available
- Check Published; check Feature on Media hub for the hero slot (only one should be featured at a time)
- Save → verify at
/media/[slug]and on/media
Featured episode
The Feature on Media hub checkbox marks the hero episode on /media. If multiple episodes are featured, the most recently published featured episode typically wins — prefer a single featured episode.
Learning path items
Include episodes in learning paths with content type PODCAST_EPISODE and the episode ID from /admin/podcasts/[id].
Newsletter signup
Many public pages include The Signal newsletter form. Episode pages inherit the site-wide signup — no per-episode newsletter config needed. See Newsletter & subscribers.