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

# Video

BeyondWords transforms written articles into videos and distributes them across your websites, apps, and third-party platforms. It allows you to scale video production efficiently, unlocking new opportunities for engagement and monetization.

You can create video articles and video summaries using advanced [AI voices](/docs-and-guides/voices/overview), relevant visuals, immersive captions, and custom branding.

<Tip>
  You can also generate and distribute [audio content](/docs-and-guides/content/audio).
</Tip>

## Generate videos by default

<Steps>
  <Step title="Enable video generation">
    Go to **Content → Preferences → Videos** in your project dashboard.

    Enable one or both of the following toggles:

    * **Convert articles into videos**
    * **Convert scripts into videos**
  </Step>

  <Step title="Select video sizes">
    Use the dropdown to select which video sizes you would like to generate: **16:9 (horizontal)** and/or **9:16 (vertical)**.

    <Tip>
      Need a custom video size? [Contact support](/docs-and-guides/support/get-support) to discuss your requirements.
    </Tip>
  </Step>

  <Step title="Choose a style template">
    Choose a [style template](#style-templates) to control the visual style of your videos.

    Click **Choose template** to choose an existing template or click **+ Create** to create a new one.

    Once complete, click **Save changes**.
  </Step>

  <Step title="Publish as usual">
    Create [content items](/docs-and-guides/content/content-items) as usual. BeyondWords will automatically convert your articles and/or [scripts](/docs-and-guides/tools/generate-scripts) into videos, as per your settings.
  </Step>
</Steps>

## Generate or edit videos manually

<Steps>
  <Step title="Open the Editor">
    Go to **Content → Items** in your project dashboard.

    Click an existing content item to open it in the [Editor](/docs-and-guides/tools/editor), or click **+ Item** to create a new item.
  </Step>

  <Step title="Select video sizes">
    Use the dropdown to select which video sizes you would like to generate: **16:9 (horizontal)** and/or **9:16 (vertical)**.
  </Step>

  <Step title="Enable video generation">
    Go to the **Video** tab in the left-hand sidebar.

    Enable one or both of the following toggles:

    * **Convert article into video**
    * **Convert script into video**
  </Step>

  <Step title="Choose a style template">
    Choose a [style template](#style-templates) to control the visual style of your videos.

    Click **Choose template** to choose an existing template or click **+ Create** to create a new one.
  </Step>

  <Step title="Generate or regenerate your content">
    Click **Generate** or **Regenerate**.

    BeyondWords will (re)generate the video and [audio](/docs-and-guides/content/audio) versions of your content, as per your latest settings. This should take no more than a couple of minutes.
  </Step>
</Steps>

## Style templates

Style templates control the visual style of your generated videos. When you create or edit a template, you can configure the following settings:

<AccordionGroup>
  <Accordion title="General">
    * **Name**: Used for your internal reference only
    * **Slug**: Used to specify the template when using the [Video settings templates API](/api-reference/video-settings-templates/list)
    * **Preview**: Preview your template in 16:9 or 9:16 format
  </Accordion>

  <Accordion title="Media">
    * **Background**: The background color used when no feature image or feature video is selected
    * **Entrance animation**: Choose how visual media animates as it enters the frame (None / Fade / Zoom in / Zoom out / Slide up / Slide down / Slide left / Slide right / Pop)
    * **Exit animation**: Choose how visual media animates as it exits the frame (None / Fade / Zoom in / Zoom out / Slide up / Slide down / Slide left / Slide right / Pop)
    * **Pan and zoom**: Enable to add subtle movement to visual media
    * **Visual timing**: Control how images and videos are timed throughout the video:
      * **Cycle continuously**: Images will loop through continuously, repeating the sequence when reaching the end
        * **Seconds**: Sets how long each image or video is shown before transitioning to the next
      * **Space evenly**: Images will be distributed evenly across the video duration, showing each image for an equal amount of time
      * **Follow article**: Images will change based on their order in the content, syncing with the corresponding text segments as they are narrated
  </Accordion>

  <Accordion title="Captions">
    **Text**:

    * **Generate captions**: Enable to display captions that follow the audio
    * **Animation**: Choose how captions appear (Classic / Reveal / Karaoke / Pop)
    * **Font**: Choose a font or upload your own
    * **Font size**: Choose a preset size or set a custom size (in pixels from 1 to 90)
    * **Casing**: Keep as is, UPPERCASE, or lowercase
    * **Primary**: Main caption text color
    * **Secondary (optional)**: Alternate caption color (will alternate scene-by-scene)
    * **Shadow (optional)**: Shadow effect color
    * **Outline (optional)**: Size in pixels and color

    **Background (optional)**:

    * **Color (optional)**: Enable to set the background color behind the caption text
    * **Radius (optional)**: The radius of the background color (0px / 8px / 24px)

    **Word highlights (optional)**: Highlight the active word as it’s being spoken

    * **Active word color**:
      * **Primary (optional)**: Main highlight color for the active word
      * **Secondary (optional)**: Alternate highlight color (alternates scene-by-scene)
    * **Active word background color**:
      * **Primary (optional)**: Main background color for the active word
      * **Secondary (optional)**: Alternate background color for the active word (alternates scene-by-scene)
  </Accordion>

  <Accordion title="Layout">
    * **Horizontal placement**: Sets where captions sit horizontally (left / center / right)
      * **Offset (%)**: Offset captions horizontally from the selected alignment position
    * **Vertical placement**: Sets where captions sit vertically (top / middle / bottom)
      * **Offset (%)**: Offset captions vertically from the selected alignment position
    * **Max lines**: Maximum number of caption lines per scene
    * **Max words**: Maximum number of words per caption scene
    * **Text width (%)**: Maximum width of the caption area
  </Accordion>

  <Accordion title="Branding">
    * **Logo (optional)**: Upload an image to add a logo overlay to your videos
      * **Logo position**: Select whether the logo appears in the top-right or top-left of the video
    * **Waveform color (optional)**: Show a dynamic waveform to visualize the audio in your videos. Set the color of the waveform using a hex code (e.g., #000000).
  </Accordion>
</AccordionGroup>

<Note>
  Click **Save changes** once you're happy with your template.
</Note>

## Visual media

Visual media are images and videos you can add to generated videos. These help add visual interest and contextual information.

There are four main types of visual media, all of which are optional:

* **Feature image**: An image used as the video thumbnail and a fallback video background
* **In-line images**: Images that appear in the video background if no feature video is set
* **Feature video**: A video used as the video background
* **Video segment**: Videos that play as standalone clips in generated videos

Images may be automatically imported from your webpage. You can upload your own media or insert pre-licensed assets from our Getty integration in the [Editor](/docs-and-guides/tools/editor).

<Info>
  The feature video takes precedence as the video background, followed by in-line images and then the feature image. If none are added or enabled, the media background color set in your style template is used.
</Info>

## Customize video

<CardGroup cols={2}>
  <Card title="Text" icon="text" href="/docs-and-guides/tools/editor">
    The text in your article and script are used to generate audio and captions.
  </Card>

  <Card title="Voices" icon="microphone-stand" href="/docs-and-guides/voices/overview">
    Choose [premade](/docs-and-guides/voices/premade-voices), [cloned](/docs-and-guides/voices/voice-cloning), or [generated](/docs-and-guides/voices/voice-generation) voices for your voiceover.
  </Card>

  <Card title="Customize speech" icon="gear" href="/docs-and-guides/voices/customization">
    Customize the speech output with pronunciation rules, pauses, and more.
  </Card>

  <Card title="Visual media" icon="image" href="/docs-and-guides/content/video#visual-media">
    Add image and video backgrounds to your generated videos.
  </Card>

  <Card title="Style template" icon="wand-magic-sparkles" href="/docs-and-guides/content/video#style-templates">
    Customize your video layout, captions, colors, animations, and more.
  </Card>

  <Card title="Insert videos" icon="clapperboard" href="/docs-and-guides/tools/editor#video-assets">
    Insert standalone video files into your generated videos.
  </Card>

  <Card title="Background music" icon="music" href="/docs-and-guides/tools/add-music">
    Use background music to add atmosphere to your video.
  </Card>
</CardGroup>

<Warning>
  The [audio](/docs-and-guides/content/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.
</Warning>

## Distribute video

<CardGroup cols={2}>
  <Card title="Player" icon="film" href="/docs-and-guides/distribution/player/player-introduction">
    Automatically or manually embed videos in the BeyondWords player.
  </Card>

  <Card title="Playlists" icon="film" href="/docs-and-guides/distribution/playlists">
    Keep viewers watching for longer with customizable video playlists.
  </Card>

  <Card title="Download" icon="download" href="/docs-and-guides/distribution/download">
    Download your videos as MP4 files for distribution across any platform.
  </Card>

  <Card title="Share via URL" icon="link" href="/docs-and-guides/distribution/share-via-url">
    Get a shareable URL featuring your video alongside your written content.
  </Card>
</CardGroup>

## Monetize video

<CardGroup cols={2}>
  <Card title="Ads" icon="money-bill" href="/docs-and-guides/monetization/ads">
    Serve direct or programmatic video ads through the BeyondWords player.
  </Card>

  <Card title="Access tiers" icon="wallet" href="/docs-and-guides/distribution/player/access-tiers">
    Customize the player experience for users on different access tiers.
  </Card>
</CardGroup>

## Analyze video

<CardGroup cols={2}>
  <Card title="Analytics dashboard" icon="chart-line" href="/docs-and-guides/analytics/analytics-dashboard">
    Analyze video engagement metrics in the analytics dashboard.
  </Card>

  <Card title="Analytics integrations" icon="chart-network" href="/docs-and-guides/analytics/analytics-integrations">
    Send video performance metrics to your preferred analytics platform.
  </Card>

  <Card title="Analytics API" icon="play-pause" href="/api-reference/analytics/organization-analytics">
    Use the API to retrieve analytics for an organization, project, content item, or ad.
  </Card>
</CardGroup>