Docs: Podcast posts

Quick Start: Adding a New Episode

1. Create the post: Go to Ghost Admin → Posts → New Post
2. Add the tag: Add the tag podcast (this is mandatory)
3. Publish: Your episode will automatically appear at /podcast/

That's it! Your podcast episode is now live.

Understanding Access Levels

The podcast page has different viewing experiences based on membership:

Members (Free or Paid)

• Can see and play ALL podcast episodes
• Full access to everything
• Pagination shows when there are more than 5 episodes

Non-Members (Not Signed In)

• See only 3 locked episode previews
• "Play Episode" button is disabled
• Must sign up to access episodes (free membership is enough)

Editing the Podcast Page Hero

The hero is the banner area at the top of your podcast page. To customize it:

1. Go to Ghost Admin → Pages
2. Find the page called "podcast-hero"
3. Edit the content and/or feature image
4. Save your changes

How the Podcast Page Works

What Visitors See

• Your podcast episodes appear at /podcast/
• Shows 5 episodes per page (for members)
• Each episode has its own page
• Non-members see a sign-up prompt after 3 locked previews

Individual Episode URLs

• Podcast episodes: /podcast/[episode-name]/

Important Notes

The podcast tag is special:

• It automatically routes posts to the podcast section
• Make sure to use podcast (not #podcast which is an internal/private tag)
• Posts tagged with podcast will ONLY appear in the podcast section

Access is members-only:

• All podcasts are accessible to any signed-in member (free or paid)
• Non-members can see previews but cannot play episodes
• There's no need for additional tags - the free tier gives full access

Tips for Success

DO:

• Add the podcast tag to all podcast episodes
• Include audio content in your episodes
• Add feature images for visual appeal
• Write engaging descriptions
• Test the page both signed in and signed out

DON'T:

• Forget the podcast tag (the episode won't appear)
• Use #podcast (the # makes it an internal tag that won't work)

Troubleshooting

Episode not showing up?

• Check that it has the podcast tag (without the #)
• Make sure it's published, not a draft

Can't play episodes?

• Make sure you're signed in (any membership tier works)
• Check that the post has audio content

Pagination not appearing?

• You need more than 5 published podcast episodes for pagination to show
• Make sure you're signed in (non-members don't see pagination)

Hero section not updating?

• Make sure you're editing the Page called "podcast-hero", not a post
• Check that you've saved your changes

Want to change how many episodes show per page?

• This requires a developer to modify the theme settings

Page URLs for Reference

• Podcast page: /podcast/
• Page 2, 3, etc: /podcast/page/2/, /podcast/page/3/
• Individual episode: /podcast/[episode-name]/

Remember: Just add the podcast tag to make any post a podcast episode. Free membership is enough for full access.