Subtitles & captions in depth

Microsoft Stream Captions: Generate, Upload and Translate

Microsoft Stream captions come from two places: a transcript Stream generates itself, or a WebVTT file you upload under Video settings, Transcripts and captions. Uploads must be WebVTT (SRT isn't accepted) and no larger than 4 MB, and Stream strips notes and styling from the file. For names, jargon or languages Stream can't generate, upload your own VTT for each language.

6 min read · Updated

How captions work in Stream today

mydubly Classic subtitle style with white text and black outline on video

Stream is now the video player and library built on SharePoint and OneDrive for Business. Older guides describing "Stream (Classic)" and its "Autogenerate a caption file" checkbox no longer apply. In the current version, a video file in SharePoint or OneDrive can have caption and transcript files attached, and the same file powers three things: the CC captions on the video, the Transcript pane viewers can read and search, and Microsoft 365 search, which can find the video by words spoken in it.

The caption file isn't visible as a separate file in the document library. It's stored with the video, inherits the video's permissions, moves and copies with it, and changes to it appear in the video's version history. So if you delete a track by mistake, version history can bring it back.

Automatic transcripts and their limits

mydubly YouTube subtitle style with white text on a dark box

Microsoft's help page describes two automatic routes, and their numbers differ:

Automatic on upload
Runs by default for videos uploaded to SharePoint, unless the tenant has turned off the Media Transcription setting. Microsoft lists a short set of locales for this (including English (United States), French (France), Spanish (Spain), Japanese and Portuguese (Brazil)) and a limit of 1 GB and 4 hours.
Generate (manual)
The video owner opens Video settings and selects Generate. Microsoft lists 28 spoken languages and locales, including several English variants, Arabic, Hindi (India), Korean, Polish and Swedish, and says generation works for videos under 4 GB and under 4 hours.

The same page gives 1 GB in one place and 4 GB in another, depending on which route it's describing. If a large file doesn't get a transcript, try Generate before assuming it's too big, and compress or split the recording if both fail.

Teams meeting recordings are a separate case: the live transcript from the meeting is copied onto the recording, so it already has captions when it lands in OneDrive or SharePoint. Transcribing a Teams recording covers what to do when that transcript is missing or poor.

Languages missing from the generation list, such as Turkish, Czech, Hebrew and Vietnamese, can only get captions in Stream through an uploaded file.

Upload Microsoft Stream captions from a VTT file

mydubly Modern subtitle style with rounded translucent caption box

You need edit rights on the video. On the video's player page in Microsoft 365:

  1. Select Video settings on the right side of the page.
  2. Expand the Transcripts and captions section if it's collapsed.
  3. Select Upload.
  4. In the dialog, choose the language of the file. This is the language name viewers will see when they switch captions on.
  5. Choose Select file and pick the .vtt file from your computer. If you picked the wrong one, remove it with the X and choose again.
  6. Confirm the upload, then play the video, select CC and pick the language to check the result.

To swap in a corrected file later, use the "..." menu next to the existing track in the same section; it offers Download, Replace and Delete.

What Stream does to your VTT file

mydubly Minimal subtitle style with clean text and soft shadow

Stream's WebVTT support is deliberately narrow. Knowing this saves rejected uploads:

  • The first line must read WEBVTT, followed by cues. Each cue is a start and end time joined by an arrow, then the text.
  • Times use a full stop before the milliseconds (00:01:04.250), not the comma SRT uses. This one character is the most common reason an SRT renamed to .vtt gets refused.
  • NOTE blocks, comments and STYLE blocks aren't supported; Stream removes them on upload. Don't rely on in-file colours or positioning.
  • Microsoft recommends no more than three lines of text per cue so the words fit on screen. Two lines is a safer habit for readability.
  • The file must be 4 MB or smaller. A text-only VTT for a multi-hour lecture is normally well within that.

If what you have is an SRT, convert it properly instead of renaming it. Converting SRT to VTT shows what changes in the file, and the free subtitle editor can import an SRT and export a VTT in one pass while you check line lengths.

Example: a compliance module for two offices

An L&D coordinator uploads a 35-minute data-handling course to a SharePoint site used by staff in Manchester and Istanbul. Stream generates English captions, but Turkish isn't on its list. She creates an English VTT from the audio, has a colleague correct product names, then makes a Turkish VTT from the same video. In Video settings she uploads both, choosing English and Turkish in the language dropdown, and staff in each office pick their language from CC.

Making VTT files with mydubly

mydubly Creator subtitle style with bold yellow outlined text for short video

Stream's built-in editor is fine for fixing a few words in the Transcript pane. For a new file, or a file in another language, generating one is quicker than typing:

  1. Open the video in the subtitle generator. The video stays in your browser; only the audio track is uploaded, processed and deleted within 30 minutes of the job finishing.
  2. Choose the spoken language and run it. Pricing is 5 credits per minute (minimum 25 credits per file), so the 35-minute course above costs 35 credits (3.5¢).
  3. Download the VTT. It already uses the WEBVTT header and full-stop timestamps Stream expects.
  4. For other languages, run the video dubbing tool on the same video and pick the target language. Translation works from the audio into any of 21 languages, and you download a VTT per language.
  5. Read each file once before uploading, ideally with someone who knows the subject. Fix names and acronyms, then upload through Video settings as above.

mydubly can't open a SharePoint or Stream link; download the video file first (from the document library's Download option, if your permissions allow it).

Editing the transcript after upload

mydubly Social Media subtitle style big centred captions for vertical video

Owners can hover over a paragraph in the Transcript pane, choose Edit, make the change and select Done. Larger rewrites are easier the long way: download the VTT from the "..." menu, edit it in a text or subtitle editor, then replace the track. Microsoft notes that a Teams transcript edited this way loses its speaker attribution, which matters if viewers relied on seeing who spoke.

Example: fixing one recurring term

A university lecturer's recorded seminar series has Stream's automatic captions writing "Bayesian" as "basin" throughout. Rather than edit dozens of paragraphs in the pane, she downloads the VTT, runs a find-and-replace in a text editor, checks the result in the subtitle editor's warnings list, and uses Replace to upload the corrected file.

Limitations

  • Stream's upload accepts WebVTT only. SRT, TTML and other formats need converting first.
  • Viewers can change caption size and colour under Playback settings, Caption settings, but only for their browser session; your file can't force a style.
  • Captions from mydubly have no speaker names or sound descriptions. Add them by hand for deaf and hard-of-hearing viewers, and see WCAG caption requirements for what accessibility policies usually expect.
  • Microsoft says generating captions inside embedded players isn't supported yet; generate or upload on the video's own player page.
  • If your tenant has disabled Media Transcription, uploading files is the only route, and the guide to translating internal company videos covers planning several language versions across teams.

Frequently asked questions

Can I upload an SRT file to Microsoft Stream?

No. Stream on SharePoint accepts WebVTT only, so convert the SRT to VTT first; renaming the file isn't enough because the timestamp format differs.

What is the caption file size limit in Stream?

Microsoft's help states a 4 MB limit for uploaded WebVTT files.

Why did Stream not generate a transcript for my video?

Automatic transcription may be disabled for your tenant or site, the language may not be supported, or the file may be over the size or 4-hour limit. Try Generate in Video settings, or upload your own VTT.

Can a Stream video have captions in several languages?

Yes. Upload one VTT per language through Transcripts and captions, choosing the matching language each time, and viewers select it from the CC button.

Where are Stream caption files stored?

With the video file in SharePoint or OneDrive. They aren't visible in the library, follow the video's permissions, and appear in the video's version history.

Do edits in the Transcript pane change the captions too?

Yes, it's the same file. Edits in the pane update both the transcript and the CC captions.