support Contact Support | system status System Status
Page Contents

    Overview: Adding Captions to a Video

    In this topic, you will learn how about working with captions in Video Cloud.

    Introduction

    Closed captions can be added to videos to provide additional or interpretive information to individuals who wish to access it. Captions are necessary so the deaf and hard of hearing can access the audio portion of video presentations.

    Example of Captions
    Example of Captions

    Such text may be used for accessibility, to provide translations of the audio track or some other purpose, but the underlying technology used is the same.

    Captions file location

    You can choose where to host the WebVTT captions file:

    1. At a Remote URL (remote asset) - In this case, the WebVTT file is hosted on your server and you add the URL for the file to the video metadata.
    2. Uploaded using Video Cloud (ingested) - In this case, the WebVTT file is uploaded (ingested) to Video Cloud. This can be done using the Media module or using the APIs.

    Associating captions with a video

    There are several ways to associate a captions file with a video:

    1. Using Studio
    2. Modifying the player publishing code
    3. Using the APIs

    Adding captions in Studio

    Captions can be associated with a video using the Media module. For information, see Adding Captions to Videos using the Media Module.

    Modifying the player publishing code

    In this case, a <track> tag is added to the player publishing code. For more information, see Adding Captions to Videos Programmatically.

    Adding captions via the APIs

    How you add captions via the APIs varies depending on whether the captions file will be ingested or used as a remote asset.

    • Remote asset captions - If you prefer to host the captions yourself (or have a captions provider who hosts them), then you can associate the captions with a video using the CMS API. For information, see Using the CMS API: Add WebVTT Captions.

    • Add captions to Video Cloud - If you want to have Brightcove host your captions, you can ingest your WebVTT file using the Dynamic Ingest API. For information, see Ingesting WebVTT Files.

    Removing captions

    Captions can be removed from videos using the Media module or via the CMS API. In Studio, open the Media module and edit the video properties. Edit the Text Tracks property as needed.

    Captions can also be removed using the CMS API by making an Update Video request and submitting a request body with an empty text_tracks array (or an array from which the object associated with that set of captions has been removed).

    Styling captions

    Styling can be applied to WebVTT captions using CSS. See Styling Captions for details.


    Page last updated on 12 Jun 2020