Skip to main content

Episodes Not Appearing

Your episode isn't showing up in the player, RSS feeds, or widgets. Here's how to diagnose and fix it.

Check the episode status​

Go to Episodes in the dashboard and find the episode. Check its status:

StatusWhat it meansWhat to do
PendingWaiting to be generatedThe generator hasn't picked it up yet. Wait a few minutes — it processes jobs on a schedule.
ProcessingCurrently being generatedThe audio generator is stitching segments. This usually takes 1–5 minutes.
ActiveReady and publishedThe episode should be visible. If it's not, check the other items below.
FailedGeneration failedClick Retry to try again. See Failed episodes below.
ArchivedSoft-deletedThe episode was archived. Restore it from the Archived tab if needed.

Check the show is published​

Episodes only appear publicly if their show is published:

  1. Go to Shows in the dashboard
  2. Find the show this episode belongs to
  3. Make sure Published is toggled on

Unpublished shows (and all their episodes) are hidden from the player, widgets, and RSS feeds.

Check the episode is public​

Individual episodes can be marked private:

  1. Go to Episodes > click the episode
  2. Make sure the Public checkbox is checked

Private episodes exist in the dashboard but don't appear in the player or feeds.

Check for recording gaps​

If the episode was auto-generated, it needs raw recording segments covering the full broadcast time:

  1. The recorder must have been running during the show's scheduled time
  2. There must be enough audio segments to cover the episode's duration

If the recorder was down during part of the broadcast (stream outage, network issue), the episode may have gaps or fail to generate.

Failed episodes​

When episode generation fails, it's usually because:

Duration mismatch​

The generated episode's duration doesn't match the scheduled duration (within a 2-minute tolerance). AutoPod retries automatically:

  • Attempt 1 — Immediate retry
  • Attempts 2–4 — Exponentially spaced retries (minutes to hours apart)
  • Attempt 5 — Final attempt; episode is accepted regardless of duration

If you see a failed episode stuck after 5 attempts, the audio generator accepted the best result. You can:

  • Listen to the episode to check quality
  • Delete and manually retry if needed
  • Check if the stream had connectivity issues during that time

Missing segments​

Not enough raw audio was available to build the episode. This happens when:

  • The recorder was stopped or restarting during the broadcast
  • The stream URL was unreachable
  • Network issues caused gaps in recording

Processing error​

A rare internal error during audio stitching. Click Retry to regenerate the episode.

Episode not appearing in RSS feeds​

If the episode is active and the show is published, but it's not in your RSS feed:

  1. Check "Exclude from RSS" — Go to Show Settings and make sure this is not checked
  2. Wait for the RSS cycle — RSS feeds regenerate every 2 minutes. New episodes appear on the next cycle.
  3. Check the feed directly — Open your RSS feed URL in a browser: https://rss.autopod.xyz/your-station.xml
  4. Podcast app delay — Apple Podcasts, Spotify, and other apps cache feeds on their own schedule (typically every few hours). The episode will appear once the app refreshes.

Episode not appearing in widgets​

Widgets pull data from the API, which caches responses for 30 seconds. If the episode is active and the show is published:

  1. Wait 30 seconds and refresh the page
  2. Check the data-station attribute matches your RSS filename
  3. If using data-show, check the show ID is correct
  4. If using data-limit, make sure the limit is high enough

Still not working?​

If none of the above resolves the issue:

  1. Check the Stream Settings page — make sure the stream is active
  2. Try viewing the episode in the API directly: https://api.autopod.xyz/v1/episodes (with your API key)
  3. Contact support with your stream ID and episode ID