Quick answers to the most frequently encountered problems. For detailed troubleshooting, see the topic-specific pages.
Episodes
| Problem | Likely cause | Quick fix |
|---|
| Episode not appearing in player | Episode still processing, or show is unpublished | Check the episode status in the dashboard. Make sure the show is published. |
| Episode has wrong duration | Recording gap or stream interruption | AutoPod retries automatically (up to 5 times). Check for failed episodes in the dashboard. |
| Episode title is wrong | Auto-generated from show name + schedule time | Edit the episode title in the dashboard. |
| Failed episode won't retry | Maximum retry attempts reached | Click Retry on the failed episode in the dashboard to restart generation. |
See Episodes Not Appearing for detailed diagnosis steps.
Schedule
| Problem | Likely cause | Quick fix |
|---|
| Schedule changes not taking effect | Changes not saved, or cache delay | Make sure you clicked Save. Changes take effect within 2–5 minutes. |
| Wrong week showing | Schedule rotation calculation | Check the current week indicator in the schedule builder. |
| Shows overlapping | Two shows assigned to the same time slot | Edit the schedule to remove the overlap. |
See Schedule Problems for detailed diagnosis steps.
Player
| Problem | Likely cause | Quick fix |
|---|
| Player not loading | Stream disabled or API endpoint unreachable | Check stream is active in Stream Settings. |
| Live stream not working | URL uses HTTP instead of HTTPS | Update the live stream URL to use HTTPS in Player Settings. |
| Colours not matching your settings | Colour cascade priority | Check Player Settings — accent colour, brand colour, and background tint each serve different purposes. See Theming & Colours. |
| Features missing from player | Feature toggles disabled | Enable the features you want in Player Settings (schedule, search, shows, etc.). |
See Player Issues for detailed diagnosis steps.
| Problem | Likely cause | Quick fix |
|---|
| Widget not appearing | SDK script missing or wrong station slug | Make sure the SDK <script> tag is on the page and the data-station attribute matches your RSS filename. |
| Widget looks wrong on your site | CSS conflicts | Widgets use Shadow DOM for isolation — this shouldn't happen. Check that the widget <div> isn't inside an element with display: none or overflow: hidden. |
See Widget Issues for detailed diagnosis steps.
| Problem | Likely cause | Quick fix |
|---|
| Feed not updating | Show excluded from RSS, or episodes not published | Check show settings — make sure "Exclude from RSS" is off. Check episodes are published. |
| Podcast app not showing new episodes | Aggregator cache delay | Podcast apps check feeds on their own schedule (usually every few hours). New episodes appear once the app refreshes. |
| Apple Podcasts submission failing | Image too small or feed validation error | Use 3000x3000 px artwork. Check the feed URL is accessible. |
Account
| Problem | Likely cause | Quick fix |
|---|
| Can't log in | Wrong password or session expired | Try resetting your password. Clear browser cookies and try again. |
| Can't see a stream | Delegate user not assigned to that stream | Ask the account owner to assign you to the stream. |
| Settings not saving | Session expired or network error | Refresh the page, log in again, and retry. Check your browser console for errors. |