Overview

Make your content more inclusive with captions for your video files stored in OneDrive for Business or SharePoint. Captions help make your video easier to consume for people who are deaf or hard-of-hearing, are playing your video in a noisy environment, or have diverse levels of language ability.  

Help viewers quickly find content relevant to them with a transcript in the web player. Viewers can browse the transcript and jump to the content they want or simply read the transcript rather than playing the video.  

A video plays in a browser. A transcription of the video plays to the right of the video.

For Teams meeting recordings, the transcript from Teams Live Transcription is copied to the video recording file stored in OneDrive for Business or SharePoint and supplies both the captions and transcript for the meeting recording. 

How to View Captions and Transcripts on a Video 

Viewing captions  

Anyone viewing a video that has a caption / transcript file can turn captions on or off by toggling the CC button in the player controls near the bottom-right side of the video.

A cursor hovers over a (CC) button in a player menu.

Customize the captions display by clicking Playback settings > Caption/Subtitles settings > Text size, color, etc. Your customizations will last for a browser session.

A menu displays options to change text size, text color, and background transparency.

Viewing transcript

Display or hide a video's transcript by selecting the Transcript button in the upper-right side of the video that has a caption / transcript file. Within the transcript, select any block of text to jump to that part of the video file. 

A cursor hover overs options for "Video settings" or "Transcript".

For users with edit permissions:

How to Manage Captions and Transcripts for Your Video 

Generate captions and transcripts 

Generate your own captions and transcripts for videos where the spoken language is English (US). Navigate to the Video settings panel and select Generate captions.  This feature is enabled by default, but can be disabled via tenant and site level settings using PowerShell. 

We're working on enabling this feature for embedded video scenarios.   

A video is open in a browser. To the right of the video a "Video settings" panel displays the option to turn captions and transcription on or off.

Caption/transcript files may take a while to generate depending on the length of the video. You can use the Refresh button to check If it has finished yet. 

A message box shows that transcription is in progress.

Once your file has been generated, you can follow the same steps for turning on Captions and Transcripts. 

Supported file extensions: "mts", "m2ts", "ts", "3g2", "3gp", "3gp2", "3gpp", "asf", "wmv", "avi", "m4v", "mov", "mp4", "mp4v", "ogg", "webm", "movie", "mkv", "mpg", "mpeg" 

Upload captions and transcripts 

Upload your own WebVTT captions and transcript file by selecting Video settings in the upper right of the web player. Expand the Transcripts and captions section if closed, then select Upload. In the dialog that appears, select the language of the file you’re uploading. Viewers will see this language when they turn captions on or off. Choose Select file to pick a WebVTT file from your computer. If you accidentally pick the wrong file, select the X icon to remove the file and choose another. 

WebVTT file format 

The first line must read WEBVTT and subsequent entries in the file are called “cues”. Cues are:  

  1. A time marker (beginning time and end times, separated by an “arrow”, -->). Valid formats for specifying time marker include  hh:mm:ss.ttt, hhhh:mm:ss.ttt, or mm:ss.ttt. Use two or four digits for hours (hh or hhhh), two digits for minutes (mm), and two digits for seconds (ss). Separate time markers with a colon (:). After ss, include a period (.) and three digits to represent  thousandths of a second (ttt).

  2. Text that should appear on the video player during a particular segment of time. Limit text to a maximum of three lines to ensure all the words will fit on the screen.

NOTE: Additional fields, such as notes, comments, styles, etc., are not supported and will be removed from the file upon upload.  

Example   

WEBVTT 
00:00:01.000 --> 00:00:05.330 
Good day everyone, my name is June Doe. 

00:00:07.608 --> 00:00:15.290 
This video teaches you how to 
build a sand castle on any beach. 

In the example above, the first caption appears after the video has played for one second, and it remains on the screen until 5.330 seconds of the video have elapsed. The next caption appears after the video has played for 7.608 seconds, and it remains on the screen until 15.290 seconds of the video have elapsed. 

Error message 

If the upload doesn’t work, you’ll see an error message and can try picking a different file. Some common errors include:  

  • Sometimes there may be errors in your WebVTT file. To work properly, your file must conform to the WebVTT format shown above.

  • Your file size exceeds the 4MB limit that this feature supports.

Note: To replace an existing caption/transcript file, you must first delete the caption/transcript file currently assigned to the video. Support for attaching multiple caption files to a video file is coming in 2022. 

Download 

If you have edit permissions for a video file that has a caption file associated with it, you can download the captions as a WebVTT file. To do so, open Video settings and expand the Transcript and captions section if it’s closed. Then select Download as .vtt (down arrow icon) next to the file. 

Delete  

To delete a transcript and caption file, open Video settings and expand the Transcripts and captions section if it’s closed. Then select the Delete icon (trash can) next to the file. 

Note: If the file you’re deleting is a transcript from a Teams meeting recording, the transcript will still be available in Teams unless you also delete it from the meeting there

If you accidentally delete a transcript and caption file, you can recover it by using version history in OneDrive for Business and SharePoint. 

How to Edit Captions and Transcripts 

Editing caption and transcript files within the transcript pane itself is not yet supported. As a workaround, you can download a transcript as a WebVTT file, edit it, then reupload it. First, download the transcript as a WebVTT file and open it in a text editor or caption or subtitle editor of your choice. Make your edits and save the file. Delete the existing transcript file from the video, then upload your edited WebVTT file in its place.  

Note: Teams live transcripts edited in this way lose the speaker attribution of who said what during the meeting. Support for editing a Teams transcript within the transcript pane itself is coming in 2022. The future version will allow you to edit a transcript and retain speaker attribution. 

How Captions and Transcripts are Stored 

The captions and transcript file is stored with the video in OneDrive for Business or SharePoint.  This inherits the same permissions and policy as the video file, so that whoever has access to the video file has access to the captions and transcript.   

There is no direct access to see or manage the captions and transcript file in the file explorer for OneDrive for Business or SharePoint.  Because this file only enhances the video viewing experience, it is viewed and managed only through the video player as described above.  

If this captions and transcript file is updated, it will update the version history of the video file it’s associated with.  To see a previous version of the captions and transcript file, you can go back in the video file version history.   

If the video file is deleted, the transcript file that is stored alongside it will also be deleted.  If a retention policy is set up for the video file, it will apply to the transcript stored alongside it as well.  If you move the video file to another location, the transcript will be moved with it.  If you copy the video file, a copy of the transcript will be made and stored with it as well.    

For Teams Meeting Recordings, the transcript from Teams Live Transcription is copied to the video recording file which is used to displays both captions and the transcript for the meeting recording.  While this meeting transcript will generally exist with the video for the lifetime of that video, we may change this architecture in the future while ensuring that recording files less than 60 days old display the transcript from the meeting as captions.  Any such changes will be clarified here and in message center notifications. 

How Videos Show Up in Search  

When a captions and transcript file is stored with the video in OneDrive for Business or SharePoint, that video can be found in M365 search by those words in the file.  This behavior is the same as any other office document type such as a Word or PowerPoint document.  Only viewers who have view permissions to the video will be able to find it in M365 search.  

Need more help?

Expand your skills
Explore Training
Get new features first
Join Microsoft Insiders

Was this information helpful?

What affected your experience?

Thank you for your feedback!

×