Custom audio files

3 min read

Sometimes you already have the audio you want to use - a human voice-over, a podcast episode, or a recording in your own brand voice. With Custom Audio you can attach your own file to any post or page and TTSWP will play it instead of the generated voice. On multilingual sites you can set a different file for each language.

Custom audio is a paid-plan feature.

What you can use

  • A file from your Media Library (pick an existing one or upload a new one)
  • A direct link to an audio file hosted anywhere (for example a CDN or podcast host)

Accepted formats: MP3, M4A, OGG, and WAV.

Add custom audio

  1. Open the Posts or Pages list in WordPress.
  2. In the TTS column, find the post you want.
    • On a single-language site you'll see one custom-audio button.
    • On a multilingual site each language has its own row, so you can set a file per language.
  3. Click the custom-audio button to open the picker.
  4. Either Browse the Media Library and choose a file, or paste a link to an audio file.
  5. Click Save.

The row now shows a Custom badge with play and download buttons. That's it - the file is live on the front end.

How it behaves

  • Custom audio overrides the generated voice. When a custom file is set for a post (and language), visitors hear your file, not the TTS voice.
  • It uses the full player. Your file plays through the same player as generated audio, including the inline player, the sticky footer player, the waveform progress bar, and the download button.
  • It mixes with generated audio per language. You can have a custom file in one language and a generated voice in another on the same post - each language serves the right audio.
  • No credits are used. Custom audio is your own file, so it never calls the voice provider and never spends credits.

Remove custom audio

Click the remove button on the row. The post falls back to its generated audio if it has any, or to the normal "Generate" action if it doesn't. Removing custom audio never deletes the file from your Media Library - it just stops using it.

If you downgrade to Free

Any custom audio you already set keeps playing for your visitors. The control to add or change custom audio is hidden until you're on a paid plan again - nothing is removed.

Known quirks

  • External links are not checked for you. If a link is wrong or the file is later deleted, the player can't load it - the same as any broken URL.
  • A file removed from your Media Library will stop playing, because the link no longer resolves.
  • Non-audio files and unsupported formats are rejected when you save, with a message explaining why.