Use the WordPress plugin

Learn how to use the BeyondWords for WordPress plugin.

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

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.

Request audio for existing posts and pages

You can request audio for one or more existing posts using 'Bulk actions':

  1. Open the relevant posts overview page in your WordPress admin ('Posts', 'Pages', or a custom post type)

  2. 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)

  3. 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.

Change the location of the audio player

The customizable audio player will render before the first part of the_content() by default. This means it should appear directly above your body content.

If you wish to change the location of the player, you can do so via your WordPress Editor:

  1. Open the relevant post or page in your WordPress Editor

  2. 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

  1. 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.



Having issues?

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:

  1. Go to the 'Content (Audios)' section of your project dashboard

  2. Hover on the audio you would like to disable or enable CMS updates for

  3. 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 1.

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 wp_insert_post function, $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?
  1. Open the post in your WordPress Editor

  2. Open the BeyondWords sidebar

  3. Uncheck 'Display player'

  4. Select 'Update'

Alternatively, you can delete or disable the audio via your BeyondWords dashboard. The corresponding Small Player will be removed automatically.

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 <figcaption> or <aside> HTML tags, or the following classes, to prevent them from being processed into audio.

  • .callout
  • .definition
  • .divduo
  • .pullquote
  • .float-out--left
  • .float-out--right
  • .float-out--right--top

Did this page help you?