Automatically create and embed audio versions of Ghost posts.
This guide explains how to connect your Ghost site to BeyondWords using the BeyondWords Ghost integration. This allows you to automatically create and embed audio versions of your posts.

1. Set up the custom integration

  1. 1.
    Log into your Ghost admin dashboard
  2. 2.
    From the left-hand menu, select 'Integrations'
  3. 3.
    Select 'Add custom integration'
  4. 4.
    Enter the name 'BeyondWords' then select 'Create'
  5. 5.
    Keep the admin API key and API URL on hand for later

2. Set up your BeyondWords project

  1. 1.
    Sign into your BeyondWords account (don't have one? Create your free account)
  2. 2.
    Go to your project dashboard (don't have one? Create a project)
  3. 3.
    Go to the 'Content' section then select 'Ghost' under 'Connect your CMS' (already created audio? You will need to navigate to 'Settings (Integration)' instead)
  4. 4.
    Copy and paste the admin API key and API URL from Ghost into the corresponding fields, then select 'Test' — you should get a 'Success' message
  5. 5.
    Copy the audio player script for use in the next stage
  6. 6.
    Select 'Save changes'

3. Insert the audio player script

Please read our advice if you are sending email newsletters via Ghost.
  1. 1.
    Go to 'Settings' in your Ghost admin
  2. 2.
    Select 'Code injection'
  3. 3.
    Paste the audio player script into a new line in 'Site Footer' then select 'Save'
The BeyondWords x Ghost integration should now be installed, activated, and enabled. BeyondWords will automatically create audio versions of new posts, with each conversion using characters. Once processed (this should take just a few minutes), the audio version will be automatically embedded into the source page via the Small Player.

Sending email newsletters

If you are sending email newsletters via Ghost, please note that audio player will not render in the email version. This is because email clients automatically disable these elements for security.
If subscribers are not aware of audio functionality upfront, they may be less likely to click through — especially when they are on the go. It's therefore a good idea to advertise audio functionality in your emails using one of these methods:
  1. 1.
    Embed audio directly: Rather than using the audio player script, you can download your audio and manually upload it to your Ghost post (using the 'Audio' block in the editor). The audio will render in an audio player, which is previewed in the audio version.
  2. 2.
    Add email-only content: When you are personalising your email newsletter using the 'Email content' block, this is a good opportunity to mention audio functionality. Make sure your subscribers know they can read or listen to your post.


Will my old posts be converted into audio?
What happens when I update a post?
Will the integration slow down my website?
Can I share my audio versions elsewhere?

Player FAQs

What does the audio player look like? Can it be customized?
Where will the player appear?
Can I remove the player from specific posts?