Set up the WordPress plugin

Learn how to set up the BeyondWordsWordPress plugin.

This guide explains how to set up the BeyondWords for WordPress plugin. Once complete, your chosen posts and pages will be automatically converted into audio and then embedded via the customizable Small Player.


Custom post types

The BeyondWords plugin works with Pages, Posts, and custom post types that have 'custom-fields' in the 'supports' array — see this WordPress resource for guidance.


Elementor users

Our plugin does not currently support Elementor. Please drop us a message if this is something you'd be interested in.

1. Set up your BeyondWords project

  1. Sign into your BeyondWords account (don't have one? Create your free account)

  2. Go to your project dashboard (don't have one? Create a project)

  3. Go to the 'Content' section then select 'WordPress' under 'Connect your CMS'

    Already created audio? You will need to navigate to 'Settings (Integration)' instead

  1. Select the AI voices you would like to use for titles and body content, then select 'Save changes' (please note that this will change the default voices for the API and Text-to-Speech Editor)
  1. Keep the API credentials (Project ID and API key) on hand for later

  2. Customize the audio player (optional)

2. Install the plugin on WordPress

  1. Log into your WP Admin dashboard

  2. From the left-hand menu, select 'Plugins' then 'Add New'

  1. Search for 'BeyondWords', select the plugin, then select 'Install and activate'
  1. Once installed, select the 'Manage Plugins' button — you will be redirected to the 'Installed Plugins' page
  1. Select 'Settings' in the BeyondWords plugin (at this stage, we also recommend enabling auto-updates — this will ensure you don't miss any improvements to the plugin)
  1. Follow the instructions provided to authenticate your account and determine your settings — if your custom post type is not appearing, please add 'custom-fields' in the 'supports' array — see this WordPress resource for guidance
  1. Select 'Save Settings'

The BeyondWords for WordPress plugin should now be installed, activated, and enabled. For posts and pages in eligible categories, audio will be processed and published automatically. This uses characters, and processing typically takes a couple of minutes.

For more information, see our guide to using the WordPress plugin.


How to disable automatic publishing

If you wish to review your audio before it is published, you will need to enable 'Pending review'.


Will my old posts be converted into audio?

BeyondWords will not automatically convert pre-existing WordPress posts into audio.

However, you can generate audio for old posts by using 'Bulk actions' or updating a post with 'Generate audio' checked.

What does the audio player look like? Can it be customized?

The WordPress plugin uses our Small Player, which supports light mode and dark mode. You can customize the Small Player in the 'Distribution (Player)' section of your project dashboard.

Where will the audio player appear?

By default, our WordPress plugin prepends the Small Player before the first part of the_content(), which you should find in your PHP templates. This means it should appear directly above your body content.

You can change the location of the player via your WordPress Editor.

The player will be automatically embedded into pages with processed audio. It will not be rendered on pages where an audio version is unavailable.

Did this page help you?