Using the Caption Editor

In this topic you will learn how to edit captions using the caption editor.

Captions can be added to videos and provide additional or interpretive information to individuals who wish to access it. Captions are associated with videos as part of the Text Track properties.

Once captions have been added to videos, the caption editor can be used to edit the caption files. The text tracks properties can be configured to provide captions for a video.

Editing a caption file

To open the caption editor, follow these steps:

  1. Navigate to the Media module.
  2. Select your video
  3. Select the Languages tab.
  4. Click the Edit text track pencil icon next to the desired text track.

  5. Make your changes to the caption file and click Publish Track.

    Caption editor

Positioning captions

By default, captions appear at the bottom center of the video. You can move any cue to one of nine positions, for example to keep a caption from covering on-screen text or a speaker's face. Positions are saved in the caption file as standard WebVTT cue settings, so the Brightcove Player shows each caption where you placed it.

To change the position of a cue, follow these steps:

  1. In the Captions panel, click the cue you want to move.
  2. Click the position dropdown on the cue. It shows the current position, such as Bottom-Center.
  3. In the Cue Position grid, click the position you want: top, middle or bottom row, and left, center or right column.

    Cue Position grid on a caption cue
  4. Play the cue in the preview player to check the new position.
  5. Click Save Draft or Publish Track to save your changes.

Custom positions

A caption file created outside the caption editor can contain cue settings that the grid cannot show, for example a vertical text direction or a line number instead of a percentage. Those cues show Custom position. The caption editor keeps their settings unchanged when you save. If you pick a position in the grid, it replaces the custom settings for that cue.

To learn how to write cue settings in a WebVTT file by hand, see Styling Captions.

Overlapping captions

When two cues are on screen at the same time but at different positions, both show an Overlapping captions warning. Viewers see both captions at once, in two places on the video. This can be intentional, for example for two speakers, so the warning never prevents you from saving. To clear it, adjust the cue times so they do not overlap, or move both cues to the same position.

Editing several cues at once

You can change the position of several cues, or delete them, in one step.

  1. In the Captions panel header, click Select Cues.
  2. Select the checkbox of each cue you want to change, or select Select All Cues. The selection bar shows how many cues are selected.
  3. To move the selected cues, open the position menu in the selection bar, pick a position in the Cue Position grid and click Apply, or click Cancel to keep the current positions. If the selected cues have different positions, the menu shows Mixed positions.

    Positioning several selected cues
  4. To remove the selected cues, click the delete (trash) icon in the selection bar, then confirm with Delete cues. A track must keep at least one cue, so you can't delete every cue in the track.
  5. To leave selection mode, click the close (X) icon in the selection bar or press Escape.
  6. Click Save Draft or Publish Track to save your changes.

Formatting caption text

Cue text is shown as it will look to viewers, with bold and italic applied instead of formatting tags.

  1. Click the cue text to edit it.
  2. Select the words you want to format. A formatting menu appears above the selection.
  3. Click the Bold (B) or Italic (I) button.

    Bold and italic formatting menu

Finding and replacing text

Use find and replace to correct a name or a repeated mistake across the whole track.

  1. In the Captions panel header, click the Find and replace search icon.
  2. Type the text to look for in Find in this track. Matches are highlighted in the cues, and the counter shows which match is current, for example 2 of 5. Select Match case to only match the same capitalization.
  3. Use the up and down arrows, or press Enter and Shift+Enter, to move between matches.
  4. Type the new text in Replace with..., then:
    • Click Replace to change only the current match.
    • Click Replace All to change every match. A message confirms how many occurrences were replaced, and in how many captions.

    Find and replace bar
  5. Press Escape or click the close icon to close find and replace.
  6. Click Save Draft or Publish Track to save your changes.

Supported WebVTT content

The caption editor keeps the parts of a WebVTT file that it does not edit, so saving does not remove them:

  • Header metadata after the WEBVTT line, such as X-TIMESTAMP-MAP used for HLS synchronization
  • STYLE blocks with caption CSS
  • REGION blocks
  • NOTE comments. Comments placed between cues are moved after the file header when you save.