> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beyondwords.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Editor
The Editor lets you create [audio](/docs-and-guides/content/audio) and [video](/docs-and-guides/content/video) from text, or edit the text and settings for existing [content items](/docs-and-guides/content/content-items). It gives you control over the following elements:
* **Article**: The main text used to generate the audio/video article
* **Script**: An optional, alternate version of your article that can be used to generate an audio summary and/or video summary
* [**Audio assets**](#audio-assets): Audio uploads that can be inserted into your content
* [**Image assets**](#image-assets): Images that can be inserted into your content
* [**Video assets**](#video-assets): Videos that can be inserted into your content
* [**Pauses**](#pauses): Manually placed pauses that can improve the flow of generated speech
* [**Voices**](#voices): The voice used for each text segment
* [Script settings](#script-settings): The script template and audio generation setting
* [Video settings](#video-settings): Settings and styling for video generation
* [**Background music**](#background-music): The background track for audio and video
* [Pronunciation rules](#pronunciation-rules): Pronunciation rules and AI preprocessing
* [Info (metadata)](#info-metadata): Content details such as visibility and publish date
## Create or edit content
Go to **Content → Items** in your project dashboard.
* To create a new content item in the Editor, click **+ Item**
* To edit an existing content item in the Editor, click the relevant item
In the **Article** section of the Editor, enter the text that you want to use to generate the audio/video article. You can also insert [audio assets](#audio-assets), [image assets](#image-assets), [video assets](#video-assets), and [pauses](#pauses), and change the [voice](#voices) associated with any text segment.
If you want to create an audio/video summary, you need to provide a script.
Click **Script** at the top to open the script editor. You then have two options:
* **Add a script**: Enter the text that you want to use to generate the audio/video summary
* [Generate a script](/docs-and-guides/tools/generate-scripts): Click **Generate script** to generate a script based on the selected [script template](/docs-and-guides/tools/generate-scripts#script-templates)
You can also insert [audio assets](#audio-assets), [image assets](#image-assets), [video assets](#video-assets), and [pauses](#pauses), and change the [voice](#voices) associated with any text segment.
Editing the [script template](/docs-and-guides/tools/generate-scripts#script-templates) in the Editor applies changes to that content item only—the project's default template is unaffected, and future updates to the default will not affect this item.
The Editor will apply your default settings, unless they were previously overwritten.
In the left-hand sidebar, you can:
* Change the [script settings](#script) for this particular content item
* Change the [video settings](#video) for this particular content item
* Change the [background music](#background-music) for this particular content item
* Add or remove [pronunciation rules](#pronunciations) for this content item, the project, or the organization
* Update or view the content item's [metadata](#info-metadata)
Editing the video style template in the Editor applies changes to that content item only—the project template is unaffected, and future project-level updates will not affect this item.
Once you're happy with your content and settings, click **Generate** or **Regenerate**.
Your item will show a "Generating" status, which will switch to a play button when processing is complete.
## Audio assets
Audio assets are audio files that can be embedded within articles and scripts for inclusion in generated audio and video. Use them to add stings, interview clips, and other elements that enhance the listening experience.
To insert an audio asset:
1. Enter "/" into a new segment or click the **+** below any segment
2. Click **Add audio**
3. Upload the audio file from your device (MP3 or WAV up to 200MB)
4. If needed, you can move, preview, or delete the audio file
You can configure an audio intro and outro in [**Distribution → Player**](/docs-and-guides/distribution/player/player-settings). BeyondWords also supports [audio ads](/docs-and-guides/monetization/ads).
## Image assets
Image assets are image files that can be embedded within articles and scripts for inclusion in generated audio and video. They can be imported automatically from your website, uploaded from your device, or sourced through our Getty integration.
There are two main types of image assets:
* **Feature image**: The main image associated with your content. This is used for video thumbnails and appears at the top of [shareable pages](/docs-and-guides/distribution/share-via-url) for audio. The topmost image is used as the feature image unless you set one manually in the right-hand sidebar.
* **Inline image**: Images inserted as segments. They appear in place on [shareable pages](/docs-and-guides/distribution/share-via-url) for audio and can be used as video backgrounds.
Image assets must be in JPEG or PNG format and up to 200MB in size.
### Insert images
To add a pre-licensed image from Getty:
1. Enter "/" into a new segment or click the **+** below any segment
2. Click **Add image → From assets**
3. Enter keywords into the search bar to find relevant images from Getty. Click the filter icon to filter based on orientation/people/publish date or sort by best match/newest/oldest.
4. Click any image to see more information—from there, you can **Set as feature image**, **Cancel**, or **Add to content**
To upload an image from your device:
1. Enter "/" into a new segment or click the **+** below any segment
2. Click **Add image → Upload**
3. Select the image from your device
### Edit images
Click any image in the Editor to:
* Delete the image
* Select which part of the image is shown in vertical and horizontal videos
* Disable the image for video generation
## Video assets
Video assets are video files that can be embedded within articles and scripts for inclusion in generated video. They can be imported automatically from your website, uploaded from your device, or sourced through our Getty integration.
There are two main types of video assets:
* **Feature video**: A video used as the background for generated videos. The video loops continuously as needed.
* **Video segment**: Videos inserted as segments in the content. Each video plays once at its designated position.
Video assets must be in MP4 format and up to 200MB in size.
BeyondWords also supports [video ads](/docs-and-guides/monetization/ads).
### Set a feature video
To set a Getty video as the feature video:
1. Open the right-hand sidebar
2. Select the **Videos** tab in the **Add media** section
3. Enter keywords into the search bar to find relevant results. Click the filter icon to filter based on orientation/people/publish date or sort by best match/newest/oldest.
4. Click any result to see more information—from there, you can **Set as feature video**
To upload a feature video from your device:
1. Open the right-hand sidebar in the Editor
2. Click **Upload video** in the **Feature** section
3. Select the file from your device
### Insert a video segment
To insert a video segment from Getty:
1. Enter "/" into a new segment **or** click the **+** below any segment
2. Click **Add video → From assets**
3. Enter keywords into the search bar to find relevant results. Click the filter icon to filter based on orientation/people/publish date or sort by best match/newest/oldest.
4. Click any result to see more information—from there, you can **Add to content**
To insert a video segment from your device:
1. Open the right-hand sidebar in the Editor
2. Click **Upload video** in the **Feature** section
3. Select the file from your device
### Edit video assets
Click any video asset in the Editor to:
* Delete it
* Select which part of the video is shown in vertical and horizontal videos
* Disable it from appearing in generated videos
## Pauses
The Editor lets you manually insert pauses into articles and scripts, so you can improve the flow of generated speech.
To insert a pause manually:
1. Open your article or script in the Editor
2. Click after the word or punctuation where you want to add a pause. (To add a pause at the end of a segment, you need to insert it before a temporary word and then delete the temporary word.)
3. Enter the desired pause duration in seconds. We recommend 0.3 seconds for pauses between segments.
4. Click **Apply**
5. **Generate** or **Regenerate** your audio
You can set default pauses after titles or between segments in [project settings](/docs-and-guides/get-started/projects).
## Voices
The Editor applies your project's default [voices](/docs-and-guides/voices/overview). To change the voice for the article, script, or a specific paragraph:
1. Click the colored icon next to a paragraph—this will open the **Voice** tab in the left-hand sidebar
2. Select the language and accent of the voice you want to use
3. Select the voice you want to use from the dropdown menu or click **+** to start the [voice cloning](/docs-and-guides/voices/voice-cloning) or [voice generation](/docs-and-guides/voices/voice-generation) process
Click any colored icon to play a voice preview. You can filter voices by native/non-native and gender.
4. Your chosen voice will be applied to the selected segment. To apply the voice to the entire article or script, click **Apply to all segments**.
## Script settings
The Editor applies your project's default settings for [scripts](/docs-and-guides/tools/generate-scripts). To change these settings, open the **Script** tab in the left-hand sidebar. You can:
* Enable or disable **Convert script into audio**
* Choose, edit, or create a script template for script generation
* Generate a script using the selected script template
To view and edit your script, click **Script** at the top of the Editor.
Editing the [script template](/docs-and-guides/tools/generate-scripts#script-templates) in the Editor applies changes to that content item only—the project's default template is unaffected, and future updates to the default will not affect this item.
## Video settings
The Editor applies your project's default settings for [generating video](/docs-and-guides/content/video). To change these settings, open the **Video** tab in the left-hand sidebar. You can:
* Choose which video formats (16:9 and/or 9:16) to generate
* Enable or disable **Convert article into video**
* Enable or disable **Convert script into video**
* Choose, edit, or create a style template to control video styling
Editing the style template in the Editor applies changes to that content item only—the project template is unaffected, and future project-level updates will not affect this item.
## Background music
The Editor applies your project's default settings for [background music](/docs-and-guides/tools/add-music). To change these settings, open the **Background music** tab in the left-hand sidebar. You can:
* Enable/disable background music
* Select or upload a track
If this content item uses the project's default background music, changes to that default will be applied if the content is regenerated.
## Pronunciation rules
The Editor applies any project-wide [pronunciation rules](/docs-and-guides/voices/customization) and your default setting for [AI preprocessing](/docs-and-guides/voices/customization).
To change these settings, open the **Pronunciations** tab in the left-hand sidebar. You can:
* Enable or disable LLM text normalization
* Delete existing pronunciation rules
* Add pronunciation rules scoped to your content, project, or organization
You can also add a new pronunciation rule by highlighting the relevant text then clicking **Add pronunciation rule**.
## Info (metadata)
In the **Info** section of the left-hand sidebar, you can see or edit the following metadata:
* **Meta title**: The content title displayed in distributions. This may differ from the title spoken in the audio.
* **Audio/video visibility**: Set visibility to public or private.
* **Publishing mode**: Select **Once generated** to make content distributable as soon as it's generated, or select **Specific date** to set a specific time for distribution.
* **Publish date**: The time that your content was or will be distributable, assuming visibility is set to public.
* **Creation date**: The date and time that your content item was created. This is not editable.
* **Author**: The author to associate with this content item. This metadata can be used when creating playlists and podcast feeds.
* **ID**: Automatically assigned by BeyondWords once generation is complete.
* **Source ID:** Add an ID from your system to link this content item to its source.
* **Source URL**: Add the original content URL to link this content item back to its source.
* **Properties**: Enable this to add custom metadata as JSON. This can be used to organize your content and power playlists and podcast feeds (e.g. `{"category": "sport"}`).
* **API updates**: Controls whether updates from integrations will apply to this content item. In other words, whether changes to the linked article are synced.
* **Play ads**: Use the toggle to enable or disable ads on this content item. Ads will only play if you also enable direct ads or programmatic ads at the project level.
## FAQs
To open the left-hand sidebar, click the **Open sidebar** icon in the top-left corner of the Editor. To close it, click the **Close sidebar** icon in the top-right corner of the sidebar.
(The left-hand sidebar is where you can access settings for voices, scripts, video, background music, and pronunciations. It's also where you can view the content's metadata.)
To open or close the right-hand sidebar, click the **Toggle sidebar** icon in the top-right corner of the Editor.
(The right-hand sidebar is where you can set your feature image and video, and search for images and videos in Getty.)
Generally, changes in the Editor apply to that [content item](/docs-and-guides/content/content-items) only and don't affect your [project defaults](/docs-and-guides/get-started/projects). The main exceptions are:
* **Voice clones**: New voice clones are made available across the project or organization, depending on the selected scope
* **Pronunciation rules**: You can delete or edit project-wide pronunciation rules via the Editor. New rules can be applied at the project or organization level, depending on the selected scope.
* **Style and script templates**: New templates are made available across the project. However, editing a template within a content item affects only that item. The project template remains unchanged, and future updates to the project template will not be applied to the content item.
* **Background music**: Newly uploaded background tracks are made available across the project or organization, depending on the selected scope
If your content is created via an integration, updates to the live article will automatically sync to the content item. This means any manual edits you make in the Editor may be overwritten.
You can prevent this by disabling API updates for the item:
1. Open the content in the Editor
2. Open the **Info** tab in the left-hand sidebar
3. Scroll down to disable **API updates**
4. Click **Regenerate** to save changes
Keep in mind that, once API updates are disabled, changes to the original article will no longer be reflected in generated audio and video.
Yes, the way that your text is formatted can affect the speech output. For example, bullet points and line breaks can change the pacing and emphasis of the generated speech.
For the most natural narration, keep paragraph structure intentional and avoid unnecessary spacing or formatting.