{{ page.title }}

{{ page.description }}

Navigating to the custom dictionary

Click on the Admin Menu and select Captions and translations.

Adding Manual Entries

Write your entries using the following syntax:
```
          
              original word or phrase,replaced word or phrase
          
        
```
Every new entry should be separated by a new line.
You can also paste your entries from a text editor or spreadsheet.
Click Save Dictionary
You will see the message Captions dictionary updated successfully.

Adding Bulk Entries

To add entries in bulk, follow the next steps:

Click Upload CSV File

Make sure you select My CSV file has a header row if your CSV has a header row.
Open your file

Your CSV file should have exactly 2 columns:
• Column 1: What you want to change (ex: my website dot com)
• Column 2: How to replace it (ex: mywebsite.com)
Click Upload CSV File
You will see the message Captions dictionary updated successfully. and the Manual Update section will show your updated entries.

Triggering the Custom Dictionary

Select Use dictionary to activate the custom dictionary while Generating captions when uploading videos.

Using the API

You can also manage your custom captions dictionary programmatically using the Brightcove Ingest API.

To retrieve the current custom dictionary, send a GET request to:

        https://ingest.api.brightcove.com/v1/accounts/{account_id}/autocaption-dictionary

Requires video-cloud/video/read scope.

To add or remove entries, send a PUT request to the same endpoint with a request body such as:
```
        {
  "add": {
    "hello": "hi",
    "world": "earth"
  },
  "remove": {
    "house": "home"
  }
}
    
```
Requires video-cloud/dynamic-ingest/create scope.
To use the dictionary during ingestion, include "use_dictionary": true next to the other transcription parameters in the ingestion request.

The dictionary is account‑wide, so updates instantly affect all future transcriptions that set use_dictionary to true.