After you have set up the BeyondWords for WordPress plugin, you can publish new posts and pages like normal. Those in your chosen categories (as determined by plugin settings) will be auto-converted into audio using your chosen voices, and then auto-embedded via the customizable Small Player. Audio processing uses characters and typically takes a couple of minutes.
Via your WordPress admin, you can also:
- Override the default setting for a particular post or page
- Request audio for existing posts and pages
- Change the player location
In the BeyondWords section of the Page/Post Settings Sidebar, as well as the dedicated BeyondWords sidebar, you will find a 'Generate audio' checkbox. The status of this checkbox determines whether or not audio is requested for a post.
The default setting for the checkbox depends on the page/post type and category, and can be determined in plugin settings (Settings > BeyondWords > 'Generate audio' settings > Preselect 'Generate audio').
If you wish to override the default for a particular post or page, you can do so by manually checking or unchecking the 'Generate audio' checkbox before updating or publishing.
You can request audio for one or more existing posts using 'Bulk actions':
Open the relevant posts overview page in your WordPress admin ('Posts', 'Pages', or a custom post type)
Use the checkboxes to select the posts you would like to request audio for (you may need to change your 'View mode' in 'Screen Options' first)
Choose 'Generate audio' from the 'Bulk actions' dropdown then select 'Apply'
You should receive a success message stating that audio has been requested. If audio already exists for any posts, these will be skipped. Once processed, the audio will be automatically embedded via the customizable Small Player.
If you wish to change the location of the player, you can do so via your WordPress Editor:
Open the relevant post or page in your WordPress Editor
There are two options, depending on whether you use the WordPress Classic Editor or Block Editor:
In the Classic Editor, select where you would like to place the player, then select 'Insert BeyondWords Player' button — a player placeholder will appear, which can be deleted or moved
In the Block Editor, press the '+' icon then select the BeyondWords block — a player placeholder will appear, which can be deleted or moved
- Select 'Publish' or 'Update' and the player will appear in the new location on your live post or page
Please note that the player will only appear when the audio is processed.
If you can't find your answer here, check out troubleshooting and support.
What happens when I update a post?
If you update the text in an audio-enabled post via WordPress, BeyondWords will automatically reprocess the audio. Once available, the new version will be streamed in the Small Player. Reprocessing usually takes just a few minutes and will only use additional characters if you add paragraphs or change voices.
If you wish to disable automatic reprocessing:
Go to the 'Content (Audios)' section of your project dashboard
Hover on the audio you would like to disable or enable CMS updates for
Select '⋮' to open the submenu, then select 'Enable CMS updates' or 'Disable CMS updates'
Can I edit the audio without editing my WordPress post?
Yes, you can use our Text-to-Speech Editor to edit your audio without editing your WordPress post. You can edit the text, change voices at a title and paragraph level, and insert your own audio clips.
How do I request audio if my posts are created programatically?
To request audio for posts that are created programatically (for example, with
wp_insert_post), set the custom field
speechkit_generate_audio with the value of
This will send the post content to the BeyondWords API for processing immediately after the post is created in WordPress.
If you are using the
$fire_after_hooks will be set to
true by default. This is a requirement — if you set this parameter to
false, audio generation will fail.
For more information, please see this WordPress guide.
How do I remove the audio player from a post?
Open the post in your WordPress Editor
Open the BeyondWords sidebar
Uncheck 'Display player'
Which fields will be converted into audio?
BeyondWords will convert your WordPress title and body content into audio using the [default voice)(doc:change-voices) set for each.
If you would like excerpts to be included in audio versions, you can use the 'Process excerpts' setting in the plugin settings. Excerpts will be prepended to your body content, meaning that they will be read aloud after the title and in the default voice chosen for body content.
Can I prevent certain elements from being processed into audio?
Yes, you can place elements within
<aside> HTML tags, or the following classes, to prevent them from being processed into audio.
Updated 23 days ago