How to use your report
Where a card shows how a change would look, it’s an example from your own feed. An option, not an instruction.
01How serious is each thing?
Five groups, the most serious first.
1,374
A link that doesn’t open the page it should. It shows an error, or the page has gone.
From the 40 podcasts we’ve checked.
Your report sorts everything into five groups. Inside each group, the most serious thing comes first.
- Not workingSomething is broken, like a link that doesn’t open. If you change only one thing, start here.
- Episode by episodeThings to look at in particular episodes. Some will be on purpose. You know which.
- Things you could turn onExtras the feed supports and your show isn’t using. Not issues. A menu.
- Worth knowingNeither good nor bad. Nothing to do, unless it’s wrong.
- What’s rightWhat’s right and needs nothing from you.
02What does each card tell me?
The label, the heading, the number, and our suggestion.
Everything your report finds gets a card of its own. A card shows, from the top down:
- The label: Links, Audio, Feed, Order or Metadata - the details of each episode, like its title, notes and artwork.
- The heading: What we saw, in one line.
- The number: How many: 2 EPISODES, 21 LINKS, 1 GAP. A card about your whole show has no number.
- Why it matters, and our suggestion: Tap the card to open it: it shows which episodes, and how the change is made. On a card with no suggestion, the button says Which episodes. In the PDF, every card is already open.
03Examples from your own feed
Your own links and titles, shown as they would look after a change.
Where you see “would read” or “would link to”, it is your own link or title, shown as it would look after the change. We’re showing you how, not telling you what to do. If you’re not sure a change is right for your show, leave it as it is.
04Where are changes made?
Changes are made at your podcast hosting platform. Apple and Spotify only show what it sends them.
Every change is made at your podcast hosting platform: the service you upload your episodes to, such as Captivate, Buzzsprout, Libsyn, Podbean or Megaphone. Apple Podcasts and the Spotify app only show what your hosting platform sends them, so no change is made there.
- Someone else runs your podcast? An agency, a producer, a network? Send them your report. Everything they need is in it.
- No setting for it? Ask your hosting platform’s support. If they can’t do it, leave it. That isn’t something you’ve done wrong.
05How do I check a change worked?
After a change, give it a few hours, then look in a podcast app on your phone.
Check it at your hosting platform. Give it a few hours. Then look in a podcast app on your phone.
Count your episodes and check their numbers at your hosting platform. Apps don’t always show episode numbers, so counting in an app can go wrong.
Apple usually shows a change within a few hours. Spotify checks every couple of hours. Either can take up to a day. In Apple Podcasts Connect you can ask Apple to look straight away: find your show and choose Refresh Feed.
Then look where your listeners look: the Apple Podcasts app if you have an iPhone, Spotify or your own listening app if you don’t.
Don’t check in a web browser. Apple’s website shows show notes as plain text. No link there can be tapped, even when yours are set up properly.
06Why does an app show something different?
Timing, links, transcripts and chapters.
640
The name of each episode. Apps show only the start of a long title, so your report notes any title longer than 90 characters. Put the words that matter first.
From the 40 podcasts we’ve checked.
Your report and every app read the same feed. Each app shows it in its own way, and catches up in its own time.
- Timing: Your report reads your feed as it is right now. Apple and Spotify check every few hours, and can take up to a day. So straight after a change, your report can show it while the app still shows the old version. That’s normal. Wait, then look again.
- Links: Apple and Spotify make a plain address tappable on their own. Not every app does, and Apple’s website never does. Your report counts what’s in your feed, which is the same for every app.
- Transcripts: If your transcript isn’t in your hosting platform, it isn’t in your feed, and listeners on other apps get none. Apple and Spotify make their own for some shows, but those stay inside Apple and Spotify. When your report says “no transcript”, it means your feed doesn’t carry one.
- Chapters: Apple makes its own for episodes that have none. That doesn’t mean your feed carries a chapters file. See Chapters, in more detail.
07I can’t find what the report means
Where to look, and three things that are harder to find.
Your report always names the episode. Find it in your hosting platform’s editor, where you upload your episodes - not in Apple or Spotify. The words your report uses are explained in our glossary The words we use. Three things are harder to find:
Stray code you can’t see
“Stray code is showing in your show notes” means the characters are hidden in an episode’s notes, left over from pasting out of Word or Google Docs. They look like an ordinary space, so you won’t spot them by reading. If the editor has an HTML or code view, switch to it, delete the code and type a space. If not, retype the paragraph, or paste it in as plain text.
Episodes by title or by number
The Free Report names each episode by its title, the way your hosting platform shows it. If your hosting platform has a number set for it, the number comes first. The Deep Audit names an episode by its number, and by its title when it has none. A number lives in its own box at your hosting platform: a number typed into the title doesn’t count, because apps read the number box.
Matching the workbook to the PDF
The PDF says what was found and why. The workbook holds the detail: one row for each piece of work, with a Done column to tick it off. Its Start here tab explains the Done and Notes columns: a blank cell means nothing to note, and “not set” means your feed doesn’t say.
- A card about episodes: Rows on What is missing, one row per episode. “Some of your episodes have no transcript” in the PDF is “This episode has no transcript” in the workbook. No number? Blank Ep column - find it by title. Every episode keeps the same # on every tab.
- A card about links: Rows on Links to check yourself, one row per address.
- A card about your whole show: On The show.
- Artwork and Audio: Hold what was measured, episode by episode: each image, and each sound file with its size, length and bitrate.
- Where the work is: Near the end of the PDF: every kind of work, how many episodes have each one, and where the change is made.
08Chapters, in more detail
The three kinds, and why Rich Chapters are worth having.
199
Chapters your hosting platform adds to an episode, where each chapter can carry its own title, picture and link. Part of Podcasting 2.0. Apple makes its own chapters for some episodes, but those only let listeners skip.
From the 40 podcasts we’ve checked.
“Chapters” can mean three things. 0 with Rich Chapters doesn’t mean you have no chapters. It means your feed doesn’t carry a chapters file.
- Times in your show notes: You type “12:30 The big question”. Listeners can skip, and you can change them after publishing. Both reports count them.
- Chapters in the audio: Built into the file itself, each with a picture and a link. They can’t be changed after publishing. The Deep Audit reads them. The Free Report never opens your audio.
- Rich Chapters: A chapters file your hosting platform attaches to each episode. Each chapter can carry a picture and a link, and you can change them after publishing. Both reports count them.
Spotify turns the times in your show notes into chapters only when they follow its rules: first at 00:00, at least three, in time order, each on its own line like (00:00) Intro, plain titles, no emojis. Apple needs the first at 00:00 too, so times that pass this check should work in Apple as well.
Why Rich Chapters are worth having
Apple’s own chapters let listeners skip, and that’s all. Rich Chapters let you send listeners somewhere: as each chapter plays, it can point to what you offer - a product, a video, your website. Spotify shows chapter titles only. Apple shows chapter links only when they point inside Apple. Most people aren’t looking at their screen while they listen, so mention the link out loud. To add them, look for a chapter editor in your hosting platform’s episode settings - chapters sit apart from the audio, so you can add them to episodes already published.
Still stuck?
Where to go next
If you still can’t find what you need, contact us.