--- title: "Subtitles and captioning" slug: "subtitles-and-captioning" updated: 2025-10-22T16:10:15Z published: 2025-10-22T16:10:15Z canonical: "documentation.deltatre.com/subtitles-and-captioning" --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.deltatre.com/llms.txt > Use this file to discover all available pages before exploring further. # Subtitles and captioning | Mobile | Tablet | Web | TV | | --- | --- | --- | --- | | ![android_watermark.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4490958972956.svg) | ![iOS.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4490959197852.svg) | ![android_watermark.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4490958972956.svg) | ![iPadOS.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4490914682524.svg) | ![HTML5.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4490951859100.svg) | ![android_watermark.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4490958972956.svg) | ![tvOS.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/5569247809180.svg) | ![HTML5.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4490951859100.svg) | ![Roku.svg](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4490959071132.svg) | ## What are subtitles and captioning? *Subtitles* are transcriptions of dialog, whereas *Captions* are written descriptions of relevant audio, e.g., "suspenseful music" or "whistle blows." Both transcriptions are synchronized with the video and support live and video-on-demand (VOD) content. By default, subtitles and captioning are disabled; however, operators can choose to specify a language for videos that display when the video stream loads via APIs. The subtitles and captioning panel supports Text-to-Speech (TTS). Learn more about this in our [accessibility](/v1/docs/accessibility) article. ### Supported subtitle and captioning formats DIVA supports the following subtitle formats: - WebVTT (Web Video Text Tracks) - SRT (SubRip Subtitle) ### Does the Audio and Subtitles icon always appear? > [!WARNING] > **Compatibility note:** DIVA 5.2 on [Android](/v1/docs/android-52-q4-22) and [Apple](/v1/docs/ios-52-q4-22). No, the Audio and Subtitles icon is dynamic, meaning if a language selection is available, the icon appears. If language selection is not available, the icon is **not** visible. The Audio and Subtitles icon supports three states: | State | Icon | Description | | --- | --- | --- | | Default | ![Audio_and_subtitles_icon_-_default.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131435140892.png) | No audio track applied to the video | | Hover | ![Audio_and_subtitles_icon_-_hover.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131399872924.png) | A tooltip displays when icon is hovered over | | Active | ![Audio_and_subtitles_icon_-_active.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131435032092.png) | Audio track applied to the video | To learn about audio track selection, read our [audio tracks](/v1/docs/alternate-audio-tracks) article. ### Can I change the subtitles and captioning language? Yes, enable, switch language, or disable subtitles and captioning if alternate options exist - these changes apply for the duration of the current DIVA session. Language options reflect those available in the selected video stream. The language selection made saves locally and applies when loading subsequent videos in the same DIVA session. To save the language options across different DIVA sessions, DIVA has to be integrated to listen to two callbacks: (onPreferredCC) and (onPreferredAudioTrack), informing the application of the language choice, and storing it for reuse across sessions. If an operator specifies a default language for the newly selected video, this language takes precedence. If the language does not exist for the newly selected video, subtitles and captioning are disabled. Select a tab below to see an example of this feature: Native mobile/tabletResponsive mobile/tabletResponsive webWebTVAndroid TVtvOSRoku ### Managing Subtitles and Captioning on Android > [!WARNING] > **Compatibility note:**UX/UI improvements as of the [Android 5.2](/v1/docs/android-52-q4-22) release. 1. Tap anywhere on the screen to display player controls. 2. Tap the **Audio and Subtitles** icon ![Audio_and_subtitles_icon_-_active.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131435032092.png) at the top of the screen. If additional subtitle languages are available, a chevron icon appears. 3. Tap *Subtitles* to display the sub-menu of alternate languages. ![Android_mobile_portrait__CC_AD_.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131458784540.png) 4. Select an alternate language from the available options. Upon selection, a tick icon displays. The change is saved locally and applied when loading streams. By default, subtitles are set to *Off* — this is configurable based on customer requirements. ![Subtitles_and_captioning__mobile_and_tablet__Android.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6280576514588.png) --- ### Managing Subtitles and Captioning on iOS and iPadOS > [!WARNING] > **Compatibility note:**UX/UI improvements as of the [Apple 5.2](/v1/docs/ios-52-q4-22) release. 1. Tap anywhere on the screen to display player controls. 2. Tap the **Audio and Subtitles** icon ![Audio_and_subtitles_icon_-_active.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131435032092.png) at the top of the screen. The currently selected subtitle language displays on the right side of the menu. If additional subtitle languages are available, a chevron icon appears. 3. Tap *Subtitles* to display the sub-menu of alternate languages. ![iOS_landscape_-_CC_AD.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131540304668.png) 4. Select an alternate language from the available options. Upon selection, a tick icon displays. The change is saved locally and applied when loading streams. By default, subtitles are set to *Off* - this is configurable based on customer requirements. ![Subtitles_and_captioning__mobile_and_tablet__-_iOS.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6280575795484.png) ### Managing Subtitles and Captioning on Responsive mobile > [!WARNING] > **Compatibility note:**UX/UI improvements as of the [Web 5.2](/v1/docs/responsive-web-52-q2-23) release. 1. Tap anywhere on the screen to display player controls. 2. Tap the **Audio and Subtitles** icon ![Audio_and_subtitles_icon_-_active.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131435032092.png) at the bottom of the screen. The currently selected subtitle language displays on the right side of the menu. If additional subtitle languages are available, a chevron icon appears. 3. Tap *Subtitles* to display the sub-menu of alternate languages. ![Subtitles_and_Captioning_UI_refresh__responsive_mobile_.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7858811189660.png) 4. Select an alternate language from the available options. Upon selection, a tick icon displays. The change is saved locally and applied when loading streams. By default, subtitles are set to *Off* - this is configurable based on customer requirements. ![Subtitles_and_Captioning_options_UI_refresh__responsive_mobile_.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7858811167644.png) --- ### Managing Subtitles and Captioning on Responsive tablet 1. Tap anywhere on the screen to display player controls. 2. Tap the **Audio and Subtitles** icon ![Audio_and_subtitles_icon_-_active.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6131435032092.png) at the bottom of the screen. The currently selected subtitle language displays on the right side of the menu. If additional subtitle languages are available, a chevron icon appears. 3. Tap *Subtitles* to display the sub-menu of alternate languages. ![Subtitles_and_captioning_UI_refresh__tablet_.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7855727788188.png) 4. Select an alternate language from the available options. Upon selection, a tick icon displays. The change is saved locally and applied when loading streams. By default, subtitles are set to *Off* - this is configurable based on customer requirements. ![Subtitles_and_captioning_options_UI_refresh__tablet_.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7855744099484.png) ### Managing Subtitles and Captioning on Responsive web (desktop) > [!WARNING] > **Compatibility note:**UX/UI improvements as of the [Web 5.2](/v1/docs/responsive-web-52-q2-23) release. 1. Hover anywhere on the screen to display player controls. 2. Select the **Audio and Subtitles** icon ![Subtitles_and_captioning_button.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7855166918684.png) at the bottom of the screen. The currently selected subtitle language displays on the right side of the menu. If additional subtitle languages are available, a chevron icon appears. 3. Select *Subtitles* to display the sub-menu of alternate languages. ![Subtitles_and_captioning_UI_refresh__web_desktop_.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7855167914652.png) 4. Select an alternate language from the available options. Upon selection, a tick icon displays. The change is saved locally and applied when loading streams. By default, subtitles are set to *Off* - this is configurable based on customer requirements. ![Subtitles_and_Captioning_options_UI_refresh__web_desktop_.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/7855205760924.png) ### Managing Subtitles and Captioning on WebTV > [!WARNING] > **Compatibility note:**Accessibility features included as part of the [WebTV 5.2](/v1/docs/responsive-web-52-q2-23) release. ![Closed_captions.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4409640761106.png) > [!NOTE] > **Notes:** > > 1. Content pauses while the subtitles and captioning panel displays. > 2. WebTV does not currently support switching video streams within the same DIVA session. > 3. Read the [accessibility](/v1/docs/accessibility) article for subtitles and captioning enhancements. See our [accessibility](/v1/docs/accessibility) article for subtitles and captioning enhancement options. Using the remote: 1. Select *up/down* arrows to display player controls. ![Subtitles_and_captioning_-_icon_selected.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6489905042588.png) 2. Select the *left* arrow to navigate to the subtitles icon ![Closed_captions_-_Subtitles_button.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4410541055634.png) 3. Select the *OK*button with the subtitles icon in focus to display the subtitles panel. 4. Select *up/down* arrows to choose a preferred language option or to disable subtitles. 5. Select the *OK* button with the preferred language option highlighted. 6. Select the *left arrow* or the *back*button to exit the subtitles panel. #### Managing Subtitles and Captioning on Android TV ![Closed_captions.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4409640761106.png) > [!NOTE] > **Note:**content pauses while the subtitles and captioning panel displays. See our [accessibility](/v1/docs/accessibility) article for subtitles and captioning enhancement options. Using the Android circular remote control: 1. Select *up/down* to display player controls. ![Subtitles_and_captioning_-_icon_selected.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6489905042588.png) 2. Select *left* to navigate to the subtitles icon ![Closed_captions_-_Subtitles_button.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4410541055634.png) 3. Select the *middle*button with the subtitles icon in focus to display the subtitles panel. 4. Select *up/down*to choose a preferred language option or to disable subtitles. 5. Select the *middle* button with the preferred language option highlighted. 6. Select *left* or the *back* button to exit the subtitles panel. #### Managing Subtitles and Captioning on tvOS > [!WARNING] > **Compatibility note:** DIVA supports tvOS 15+ Apple TV uses *automatic subtitles*, *Closed Captions*, and *Subtitles.* - Automatic subtitles are applied automatically and are managed within the native tvOS settings. Subtitles display in the device's preferred language. For more information, refer to the [*Apple TV App User Guide: Turn on Closed Captions and SDH*](https://support.apple.com/en-gb/guide/tvapp/atvb5ca42eb9/web#:~:text=Turn%20on%20Closed%20Captions%20and%20SDH)*.* - Subtitles and Closed Captions: For information, refer to the [*Apple TV User Guide: Control what's playing on the Apple TV app: Turn on Subtitles and Closed Captioning (if available)*](https://support.apple.com/en-gb/guide/tvapp/atvbfbcc3987/1.0/web/1.0#atvbac97b2e7:~:text=Turn%20on%20subtitles%20and%20closed%20captioning%20(if%20available)) See our [accessibility](/v1/docs/accessibility) article for subtitles and captioning enhancement options. ![Accessibility_Closed_caption_tvOS.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6699197178268.png) *Subtitles and Closed Captions on tvOS 15 (language options display if available)* ![Closed_captions_-_tvOS.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6628751458460.png) *Example showing Closed Captions on tvOS* #### Managing Subtitles and Captioning on Roku > [!NOTE] > **Note:**Content pauses while the subtitles and captioning panel displays. See our [accessibility](/v1/docs/accessibility) article for subtitles and captioning enhancement options. To manage subtitles and captioning, using the Roku remote control: 1. Select the *up*arrow to display player controls. 2. Select the *left*arrow to navigate to the subtitles icon ![Closed_captions_-_Subtitles_button.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/4410541055634.png) ![Subtitles_and_captioning_-_icon_selected.png](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/6489905042588.png) 3. Select *OK* with the subtitles icon in focus to display the subtitles panel. 4. Select *up/down* arrows to choose a preferred language option or to disable subtitles and captioning. 5. Select *OK*with the preferred language option highlighted. 6. Select the *left* arrow or the *back* button to exit the subtitles and captioning panel.