If a post has audio but visitors don’t see the player, work through the checks below. The player is added automatically on single post and page views when the post has an audio file, so the cause is usually the page type, a cache, the theme, or the file itself.

Confirm the post has an audio file

Open the post in the editor. The AI TTS box should show a preview player and a file URL. If it shows the Generate TTS button instead, there’s no file. A locally stored file that was deleted from the server (by a cleanup plugin, a migration or FTP) is detected when you open the editor, and the link is removed, so you’ll need to generate again. You can also check AI Text-to-Speech › TTS Files.

Check you’re viewing the single post

The player only appears on the post’s own page. It isn’t shown on the blog page, archives, search results or in excerpts. If you want audio in one of those places, add it with code; see Hooks, filters and code examples.

Clear your caches

Page caching plugins, your host’s cache and CDNs can keep serving the version of the page from before the audio existed. Clear the cache for that URL (or all caches) and reload in a private window.

Check your theme or page builder

The player is added through WordPress’s standard the_content filter, inside the main loop. Some themes, page builders and custom templates output the post body in a different way, so the filter never runs. To test, switch to a default theme such as Twenty Twenty-Five in a staging copy. If the player appears there, add the [ai_tts_player] shortcode to the post or to a shortcode element in your builder template where you want it.

The player shows but won’t play

• Copy the file URL from the AI TTS box and open it in a new tab. A 404 means the file is missing: generate again.
• A 403 error usually means a security plugin or server rule blocks direct access to files in /wp-content/uploads/. Allow .mp3 files in the ai-text-to-speech folder.
• If the site moved domain or switched to HTTPS, the stored URL may still point at the old address. Run a search and replace on the database for the old URL, then clear caches.
• For Dropbox files, check the file is still in your Dropbox app folder and that its shared link hasn’t been disabled.

The player shows twice

This can happen if [ai_tts_player] is placed outside the post content (for example in a theme template or widget) while the automatic player is still active. Either put the shortcode inside the post content, or remove the automatic player with the code snippet in the developer docs.

Related

• Display the audio player on posts
• Customise the audio player