Embed player (auto)

Automatically embed audio versions into their source pages.
We've launched the new BeyondWords Player in beta! Contact us at [email protected] for early access
️If you have followed setup instructions for the WordPress plugin or Ghost integration, automatic embedding is already enabled. Please ignore this guide.
This guide explains how to set up automatic embedding on your website or app. This means that audio versions are automatically embedded into their source pages via a customizable player, allowing you to publish audio articles instantly and effortlessly.
You can use any of the following methods, depending on your setup and player preferences:
The code will check whether there is an audio version of each page on your website or app by comparing the page URL/ID against the audio metadata. (If you are creating audio with our TTS Editor, you will need to enter the URL metadata when requested.)
When an audio version is processed and published, the player will render with corresponding audio. It will not render on pages where an audio version is unavailable.


When will the player appear?
The player will only render on a page if:
  • There is an audio version of the page available (according to metadata)
  • The audio is processed
  • The audio is published
What happens if I edit my audio?
The player will always stream the latest version of the audio (once fully processed). If you are still seeing the old version, you may need to clear your cache.
Will automatic embedding slow down my website?
No, automatic embedding should not slow down your website. We’ve designed BeyondWords to minimize any effect on latency. Our default JavaScript player is lightweight and, when embedded via iFrame, it only loads after all other page content has loaded. We’re also the only text-to-speech service that transcodes audio for HLS (HTTP Live Streaming), which splits audio into 15-second segments at different bit rates to ensure frictionless listening.
Can I review my audio before it is embedded?
If you would like to review your audio before it is distributed, you will need to disable automatic publishing.