Pod documentation

Setting up and configuring the Pod theme, in 7 steps. Work through them in order, or jump to what you need.

1. 1 Getting started with Pod Install Pod, wire the /podcast/rss/ + /subscribe/ routes, and publish your first episode. Ten minutes end-to-end.
2. 2 Episode metadata generator Generate the exact Ghost code-injection block Pod needs for each episode — chapters, duration, Podcasting 2.0 tags. Live preview, copy-paste ready.
3. 3 Hosting your audio files Three ways to give Pod your MP3s — upload to Ghost, point at any external URL via a code-injection marker, or drop an <audio> HTML card in the post body. Which one to use, when to switch, and what to watch out for.
4. 4 Where listeners subscribe How Pod's /subscribe/ page, homepage band, and end-of-episode CTA work — the ten podcast apps that always appear, the six that need a show URL from you, and how the deep links actually work under the hood.
5. 5 Submitting your show to Apple Podcasts + Spotify The submission workflow — what Apple + Spotify's forms want, how to verify ownership, and what happens after approval. Includes the closed-catalog apps (Amazon, YouTube Music, iHeartRadio, Castbox, Pandora) and how to wire them into Pod.
6. 6 Podcasting 2.0 settings Deep-dive on the channel-level Podcasting 2.0 fields Pod exposes as custom settings — <podcast:guid>, <podcast:locked>, <podcast:funding> (with Ghost tipjar fallback), <podcast:value> for Lightning. When to care, when to skip, and what's supported per-episode.
7. 7 Troubleshooting Common Pod problems and their fixes — missing episodes on the homepage, a 404 at /podcast/rss/, Apple submission rejections, audio that won't play, chapters not appearing, and the rest.

Back to the Pod theme