Scripts

Learn how to use script templates to transform your articles into editable scripts for audio and video, using prompts that shape tone, length, and format.

Overview

With script templates, BeyondWords turns your articles into editable scripts before generating audio and video.

Each template applies a structured prompt to shape tone, length, and format, so you can create versions of your story made for listening, watching, or both—without rewriting from scratch.

Create scripts for all your articles

1. Enable automatic scripts

   Go to Content → Preferences → Script and scroll down to Script template. Select Choose template to select a pre-made template or click + Create to create your own script template.

2. Enable audio generation

   To convert scripts into audio by default, go to Content → Preferences → Script, enable Convert script into audio, and click Save changes.

3. Enable video generation

   To convert scripts into video by default, go to Content → Preferences → Videos, enable Convert scripts into videos*, and click Save changes.

To generate scripts for existing articles, manually update them in the Editor or by clicking Regenerate. Otherwise, scripts will only be created for new articles.

Create or edit scripts for individual articles

1. Open the article in the editor

   Go to Content → Articles and open the article you want to create or edit the script for.

   Or, click + New → Article to create an article from scratch.

2. Edit the script

   Click Script at the top to view the script for this article.

   You can add your own script to the editor or generate a script.

   To generate a script, open the Script tab in the left-hand sidebar, choose or create a script template, then click Generate script. You can regenerate the script as many times as you like.

3. Enable or disable audio

   To enable or disable audio for the script, go to the Script section of the sidebar and adjust the Convert script into audio toggle.

4. Enable or disable video

   To enable or disable video for the script, go to the Video section of the sidebar and adjust the Convert script into video toggle.

5. Generate the audio and/or video

   When you’re happy with your content and settings, click Generate or Regenerate.

Create a script template

Script templates let you control how your articles are adapted for audio and video. Each template defines a structured prompt that reshapes your content—adjusting length, structure, and style—so your stories are optimized for listening or watching, while staying true to the original article. Script templates can be created either via Content → Preferences → Scripts → + Create, or directly within the Editor under the Script tab.

Template name

Name your template—this will also generate the slug. If you’re creating content via the API, the slug can be referenced in the summary settings to apply this template.

Script instructions

Specify how the article should be rewritten, including tone, structure, and length. The default scripts can be used as a reference.

AI model

Select the AI model used to generate the script. If you are interested in using another model, please contact support.

Style variation

Lower values keep phrasing closer to the article; higher values allow more variation in wording, without adding new information.

Distribute audio and video summaries

The script versions are referred to as the audio summary and video summary.

Playing the audio script

Once the script version has been generated for your article, you can load it in the BeyondWords Player by adding summary: true to the embed configuration:

<script async defer src="https://proxy.beyondwords.io/npm/@beyondwords/player@latest/dist/umd.js"
  onload="new BeyondWords.Player({
    target: this,
    projectId: <projectId>>,
    contentId: '<contentID>',
    summary: true,
  })">
</script>

Playing the video script

To load the script-based video in the player, add both summary: true and video: true to your embed configuration:

<script async defer src="https://proxy.beyondwords.io/npm/@beyondwords/player@latest/dist/umd.js"
  onload="new BeyondWords.Player({
    target: this,
    projectId: <projectId>>,
    contentId: '<contentID>',
    summary: true,
    video: true
  })">
</script>

Embed the player manually

To manually embed the player for the audio or video summary, find the article in Content → Articles and click the corresponding … icon.

Click Get embed code then choose to share the Audio summary or Video summary.

You can then copy the script and paste it wherever you want.

Download the audio or video summary

To download the audio or video summary as an MP4 file, find the article in Content → Articles and click the corresponding … icon.

Click Download, choose to share the Audio summary or Video summary, then click the button for the size(s) you want.

Share the audio or video summary via URL

To share the audio or video summary via URL, find the article in Content → Articles and click the corresponding … icon.

Click Get shareable URL, choose the Audio summary or Video summary, then copy the URL.