Replace an episode with a new media file
Replace an Episode's Media File
Swap out an episode's audio or video file without deleting the episode or losing analytics.
When to Replace a File
Common reasons to replace an episode file:
- You uploaded the wrong file
- You need to fix an audio error (edit out a mistake, improve audio quality)
- You're converting from one format to another
- You need to update the content but keep the same episode listing
Replacing the file preserves your episode's analytics, publish date, and position in directories.
Best Practice: Rename the New File
Before uploading your replacement file, give it a different filename than the original.
Why? Podcast directories cache files based on their URL/filename. A new filename ensures directories recognize the update and re-download the file.
Example:
- Original:
episode-10.mp3 - Replacement:
episode-10-v2.mp3orepisode-10-updated.mp3
Replace a File in Castos
- Sign in to your Castos dashboard
- Click on your podcast, then click the episode title
- Click Replace File
- Select or drag-and-drop your new media file
- Click Update
The new file replaces the old one in your RSS feed immediately.
Replace a File in WordPress (SSP)
Important: If you use WordPress with Castos, always replace files in WordPress—not directly in Castos. This keeps your WordPress and Castos content in sync.
- Sign in to your WordPress admin dashboard
- Go to Podcasting → All Episodes
- Click Edit on the episode
- In the Podcast Episode Details section, click Select File
- Upload your new media file
- Click Update to save to the episode changes
The episode will sync the new file to Castos automatically.
After Replacing
Directory updates
Podcast directories will pick up the new file on their next RSS feed check—usually within 24-48 hours.
Already-downloaded episodes
Listeners who already downloaded the original file will still have the old version. They would need to re-download the episode to get the updated file.
Transcripts
If you have automatic transcriptions enabled, replacing a file does not automatically regenerate the transcript. If you need an updated transcript, contact Castos support at hello@castos.com to reset the transcript process.
YouTube republishing
If you've republished the episode to YouTube, the video will not automatically update. Contact Castos support to reset YouTube Republishing for the episode.
Troubleshooting
| Issue | Solution |
|---|---|
| Directories still showing old episode | Wait 24-48 hours; try renaming the file with a unique name |
| File won't upload | Check file format (MP3, M4A, for audio; MP4 for video) and size (max 4GB) |
| WordPress changes not syncing | Verify your API key is connected in Podcasting → Settings → Hosting |
| Castos changes not appearing in WordPress | The sync is one-way (WordPress → Castos only). Make changes in WordPress. |