Ghost plugin

Automatically create and embed audio versions of Ghost posts.

This guide explains how to connect your Ghost site to BeyondWords using the BeyondWords x Ghost integration.

This allows you to automatically create and embed audio versions of your posts.

1. Set up the custom integration

  1. Log into your Ghost admin dashboard

  2. From the left-hand menu, select 'Integrations'

  3. Select 'Add custom integration'

  1. Enter the name 'BeyondWords' then select 'Create'

  2. Keep the admin API key and API URL on hand for later

2. Create a Ghost project on BeyondWords

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

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

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

  3. Select 'Ghost' under 'Connect your CMS'

  1. Select the AI voices you would like to use for titles and body content (please note that this will also change the default voices for the API and Text-to-Speech Editor)

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

  1. Copy the audio player script for use in the next stage

  2. Select 'Save changes'

3. Insert the audio player script

  1. Go to 'Settings' in your Ghost admin
  1. Select 'Code injection'
  1. Paste the audio player script into a new line in 'Site Footer' then select 'Save'

    Please note: While the audio player script is inserted into the Site Footer section, the Small Player will be embedded below the header, at the top of your audio-enabled posts. If you would like to change this default position, you can edit your post.hbs template and add an empty div with the class ‘speechkit-container’ where you would like to see the player.

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.

You can customize the Small Player in the 'Distribution (Player)' section of your project dashboard.


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 Ghost posts into audio. However, you can trigger audio processing by updating an old post.

You can also manually convert old posts into audio using the BeyondWords Editor and then embed the Small or Medium Player via iFrame.

What happens when I update a post?

If you update the text in an audio-enabled post via Ghost, BeyondWords will automatically reprocess the audio. Once available, the new version will be streamed in the Player. Reprocessing usually takes just a few minutes and will not use any additional characters.

If you update the text in an old page or post that does not currently have audio, this will trigger audio processing. This will use characters and the Player will be embedded like normal.

If you wish to edit the audio script without editing your Ghost post, see our instructions on editing audio.

Can I customize the Player's appearance?

Yes, you can customize the Small Player used by the Ghost integration.

Can I remove the Player from specific posts?

Yes, you can remove the automatically embedded Player from specific Ghost posts by disabling the corresponding audio. However, please note that this will affect all distributions of this audio.

Will the integration slow down my website?

Our Ghost integration should not slow down your website. We’ve designed BeyondWords to minimize any effect on latency. The JavaScript player is lightweight and embedded via an iFrame, which means that 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 share my audio versions elsewhere?

Yes, there are many other ways to distribute audio versions of your Ghost posts.

All of your audio versions will be available in the 'Content (Audios)' section of your project dashboard, where you can:

You can also distribute your audio content via podcast feed or share a 'latest audio' playlist.

What's next
Did this page help you?