Skip to main content
In BeyondWords, each piece of content is stored as a content item. Content items can be created through integrations, URL imports, or the Editor. Each content item includes an article (the main piece of text used to generate audio/video) and can optionally include a script (an alternate version of the article created specifically for audio/video). Scripts can be generated automatically or added manually in the Editor. Each content item can generate up to four outputs:
  • Audio article (required): Audio version of your article
  • Audio summary (optional): Audio version of your script
  • Video article (optional): Video version of your article
  • Video summary (optional): Video version of your script
The audio generated for your audio article is also used in your video article. Likewise, the audio generated for your audio summary is used in your video summary. This means any changes to the audio will affect both formats.

​
View content items

You can view your BeyondWords content in the Content → Items section of your project dashboard. The table shows the following information:
  • Status: Hover on the icon to view the status of your audio/video:
    • Generated (play button): Audio/video has successfully generated
    • Queued: Waiting to begin generation
    • Generating: Currently being generated
    • Draft: Generation has not yet been requested
    • Skipped: Generation was skipped, usually because there were not enough credits
  • Error: Generation failed—please try regenerating the content item
  • Title: The content’s meta title (learn more below)
  • Duration: The duration of your audio article
  • Published date: The publish date set on the content item, which may not be equivalent to the creation date
It typically takes less than a couple of minutes for audio/video to be processed.

​
View content metadata

To copy a content ID:
  1. Go to Content → Items in your project dashboard
  2. Click ••• alongside the relevant content item
  3. Click Copy ID
You can also view the content ID in the Info section of the Editor.
To copy a source ID:
  1. Go to Content → Items in your project dashboard
  2. Click ••• alongside the relevant content item
  3. Click Copy source ID
You can also view the source ID in the Info section of the Editor.
To view or copy a source URL:
  1. Open the relevant content item in the Editor
  2. Go to the Info tab in the left-hand sidebar
  3. View or copy the Source URL field
The meta title is the content title displayed across BeyondWords distributions, including the player and podcast feeds. It’s not necessarily the same as the title spoken in the audio.The meta title is set when the first segment of your article is created. If this first segment is later changed, the meta title does not automatically synchronize with the updated text.To update the meta title:
  1. Open the relevant content item in the Editor
  2. Go to the Info tab in the left-hand sidebar
  3. Edit the **Meta title **field
  4. Click Regenerate to save your changes
The publish date is when content was or will be made available through distributions, assuming privacy is set to public.To view or edit the publish date: 
  1. Open the relevant content item in the Editor
  2. Go to the Info tab in the left-hand sidebar
  3. View or edit the Publish date field
  4. Click Regenerate to save any changes
To view a content item’s creation date:
  1. Open the relevant content item in the Editor
  2. Go to the Info tab in the left-hand sidebar
  3. Refer to the Creation date field
Author metadata can be used to create author-based playlists and podcast feeds. To view or edit the author field:
  1. Open the relevant content item in the Editor
  2. Go to the Info tab in the left-hand sidebar
  3. View or edit the Author field
  4. Click Regenerate to save any changes
Define custom metadata as JSON objects to create smart playlists and podcast feeds based on your chosen criteria.
  1. Open the relevant content item in the Editor
  2. Go to the Info tab in the left-hand sidebar
  3. Switch on the Properties: Advanced toggle
  4. Click Add property and enter your property in JSON format
  5. Click Regenerate to save any changes
Example property:
{
  "category": "sport",
  "region": "uk"
}

​
Preview content

Once generated, you can preview generated audio/video in the Content → Items section of your project dashboard.
  • Click the Play button to hear the audio article
  • Click the View summary icon to view the audio summary in the Share dialog. (From there, you can also preview the audio article, video article, and video summary.)
  • Click the View video icon to view the video article in the Share dialog. (From there, you can also preview the video summary, audio article, and audio summary.)
For a more controlled preview, we recommend using shareable URLs. However, these won’t work if the content’s visibility is set to private or the publish date is in the future.

​
Edit content

To edit content, go to the the Content → Items section of your project dashboard and select the relevant item to open the Editor. The Editor allows you to edit article and script text, customize audio and video settings, update metadata, and regenerate audio and video. If you integrate with BeyondWords, edits to your live articles are synced automatically by default. This ensures your audio and video articles stay up to date with the source content.

​
Regenerate content

Regeneration reprocesses your audio and video using the content item’s current settings. This is useful when:
  • You have updated your content extraction or generation settings
  • There was an error with content extraction or generation
Regeneration can happen automatically or be triggered manually.
Regenerated content may take up to 5 minutes to appear in the player due to caching.

​
Automatic regeneration

If you integrate with BeyondWords, we periodically check your source articles for updates. When updates are detected, the audio/video article are regenerated automatically to keep them in sync with the source content. To switch off automatic updates for a content item:
  1. Open the content item in the Editor
  2. Go to the Info tab
  3. Disable the API updates toggle
  4. Regenerate your content like normal

​
Manual regeneration

To manually regenerate content:
  1. Go to the Content → Items section of your project dashboard
  2. Click ••• → Regenerate alongside the content item you want to regenerate
  3. Click Regenerate to confirm
If you regenerate an article, you’re only charged for the segment or segments that need to be regenerated. For example, if you correct a typo, you will only be charged for regenerating the paragraph containing that typo.
If your new settings are not being applied after regeneration, it’s likely because the content item is using settings that were intentionally preserved from when it was first created.For example, if you change your project’s default voice and then regenerate existing content items, those items will continue to use their original voices.To update these kinds of settings, you need to update the content item directly in the Editor or through the API before regenerating.
If automatic regeneration is enabled for an article, changes that you make in the Editor may be inadvertently overwritten when you make changes to the live article. To prevent this from happening: 
  1. Go to the Info tab in the Editor
  2. Disable the API updates toggle
  3. Regenerate your content like normal