Como adicionar um arquivo de legenda ao seu vídeo
Três caminhos para pôr um arquivo SRT ou VTT no seu vídeo: enviar a uma plataforma, usar o elemento track em uma página HTML com código completo ou gravar na imagem.
Ilustração original do irokod.com, gerada para este artigo.
Você já tem o arquivo de legenda pronto e agora precisa fazê-lo aparecer no vídeo. O caminho depende de onde o vídeo será visto. Numa plataforma de vídeo, o arquivo é enviado por uma tela de legendas. Numa página sua, ele é ligado ao vídeo por um elemento do HTML chamado track. Há ainda a opção de gravar o texto na imagem, que tem outro artigo. Este texto mostra os dois primeiros caminhos, com o que as páginas de ajuda dizem e com um código completo que você pode copiar. Todas as páginas citadas foram consultadas em 19 de novembro de 2026.
Três caminhos
- Enviar o arquivo a uma plataforma de vídeo. A plataforma guarda a legenda e oferece o botão para ligá-la. O exemplo aqui é a ajuda do YouTube.
- Conectar o arquivo ao vídeo que está numa página. Você escreve o HTML e publica o vídeo, o arquivo de legenda e a página no mesmo lugar.
- Gravar a legenda na imagem. O texto vira parte do vídeo e não pode ser desligado. Esse caminho fica em legenda embutida na imagem ou arquivo separado.
O formato do arquivo muda conforme o caminho. A plataforma do exemplo aceita SRT e VTT, como a tabela adiante mostra. O elemento track pede um arquivo .vtt, segundo o MDN. Se você tem um SRT e precisa de VTT, abra o arquivo no editor do irokod.com e baixe a versão em VTT. O passo a passo está em converter SRT em VTT. Para escolher entre os dois formatos, veja SRT ou VTT.
Enviar o arquivo a uma plataforma
A página de ajuda do YouTube descreve o caminho. Os nomes dos botões abaixo seguem a página, que está em inglês, e a sua tela pode mostrá-los traduzidos.
- Entre no YouTube Studio.
- No menu da esquerda, escolha Subtitles.
- Selecione o vídeo.
- Clique em ADD LANGUAGE e escolha o idioma.
- Em Subtitles, clique em ADD.
- Escolha uma das opções: Upload file, Type manually, Auto-sync ou Auto-translate.
A página diz que também dá para adicionar legendas durante o envio do vídeo.
Em Upload file, você escolhe entre “With timing” e “Without timing” antes de continuar. A página não explica a diferença entre as duas. Ela só diz que os arquivos de legenda trazem marcas de tempo de quando cada linha aparece, e pede que você confirme se o tipo de arquivo é compatível. Em Type manually, você digita ou cola a transcrição, e as marcas de tempo são definidas automaticamente. Em Auto-sync, você informa as palavras do vídeo ou envia um arquivo de transcrição, e o YouTube sincroniza o tempo. A sincronização pode levar alguns minutos, e a página não a recomenda para vídeos com mais de uma hora nem para áudio de baixa qualidade. A seção chamada Auto-translate descreve, na verdade, legendas automáticas, publicadas apenas no idioma padrão do vídeo.
A página de formatos aceitos separa os arquivos em três grupos. A tabela resume o que ela diz.
| Grupo | Formatos listados | Observações da página |
|---|---|---|
| Básicos | .srt, .sbv ou .sub, .mpsub, .lrc, .cap (Videotron Lambda) | SRT e SBV só nas versões básicas, em UTF-8 simples. SRT sem marcação de estilo |
| Avançados | .smi ou .sami, .rt, .vtt, .ttml, .dfxp | VTT com posicionamento e estilo limitado a negrito, itálico e sublinhado. TTML com implementação parcial |
| Transmissão | .scc, .stl, .tds, .cin, .asc, .cap (Cheetah e NCI) | O .scc é o formato preferido quando as legendas se baseiam em recursos CEA-608 |
Usar o elemento track em uma página
O MDN descreve o track como um filho de video ou audio que indica uma trilha de texto sincronizada com a mídia. Dá para usar várias trilhas no mesmo vídeo, por exemplo uma por idioma. O track é um elemento vazio: tem tag de abertura e não tem tag de fechamento.
Este exemplo é completo e foi escrito para este texto, com base na página do MDN. Ele assume três arquivos na mesma pasta: aula-1.mp4, aula-1.pt.vtt e aula-1.en.vtt.
<!doctype html>
<html lang="pt">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Aula 1 com legenda</title>
</head>
<body>
<h1>Aula 1: organizando arquivos</h1>
<video controls width="640">
<source src="aula-1.mp4" type="video/mp4">
<track
kind="captions"
src="aula-1.pt.vtt"
srclang="pt"
label="Português (legenda)"
default>
<track
kind="subtitles"
src="aula-1.en.vtt"
srclang="en"
label="English">
<p>Seu navegador não reproduz este vídeo. <a href="aula-1.mp4">Abra o arquivo do vídeo</a>.</p>
</video>
</body>
</html>
O arquivo aula-1.pt.vtt pode ser tão simples quanto este:
WEBVTT
00:00:01.000 --> 00:00:04.000
Hoje vamos organizar os arquivos do projeto.
00:00:04.500 --> 00:00:08.000
Primeiro, crie uma pasta chamada aulas.
Repare na primeira linha, WEBVTT, e no ponto que separa os milissegundos, em vez da vírgula do SRT. As duas exigências vêm do W3C. Os detalhes do formato estão em o que é um arquivo VTT.
Rótulos, idioma e legenda padrão
Cada atributo do exemplo tem uma função, segundo o MDN.
kinddiz como a trilha será usada. Os valores sãosubtitles,captions,descriptions,chaptersemetadata. Se o atributo for omitido, valesubtitles.srcaponta para o arquivo.vtt. Sem ele a trilha não existe, e o endereço precisa ser da mesma origem da página, salvo se ovideotiver o atributocrossorigin.srclanginforma o idioma do texto, com uma etiqueta de idioma válida. Quandokindésubtitles, ele precisa estar presente.labelé o título legível que o navegador mostra ao listar as trilhas.defaultliga a trilha, a menos que as preferências da pessoa apontem outra. Use em apenas umtrackde cada vídeo.
Não repita, no mesmo vídeo, a combinação de kind, srclang e label em duas trilhas. Na dúvida entre captions e subtitles: o MDN reserva captions para quem não ouve, pois inclui sons e falantes, e subtitles para quem ouve mas não entende o idioma.
O tutorial do MDN lembra que o navegador mostra um botão nativo de legendas quando oferece suporte. Quem cria controles próprios perde esse botão e precisa fazer o seu. A página também diz que o suporte muda de navegador para navegador. O pseudo-elemento ::cue estiliza os cues, mas só aceita algumas propriedades, como cor, fundo, fonte e sombra de texto.
Conferir se funcionou
Se a legenda não aparece com a página aberta direto do seu computador, uma causa possível é a regra de mesma origem do MDN. Teste a página num endereço da web de verdade. Esta é uma hipótese de diagnóstico, e não um fato descrito pelas páginas consultadas. Outros problemas estão em arquivo de legenda que não abre.
Erros comuns
- Apontar o
trackpara um SRT. A causa é supor que qualquer formato funciona. O MDN fala em arquivo.vtt. Converta o SRT antes. - Faltar a linha WEBVTT ou usar vírgula nos tempos. A causa é converter à mão. O formato exige o cabeçalho e o ponto nos milissegundos.
- Marcar
defaultem duas trilhas. A causa é copiar o bloco sem revisar. Só uma trilha pode ter o atributo. - Esquecer o
srclangemsubtitles. A causa é achar que olabelbasta. O idioma é obrigatório nesse caso. - Guardar o
.vttem outro endereço. A causa é hospedar os arquivos em lugares diferentes. A origem deve ser a mesma da página, ou ovideoprecisa decrossorigin. - Salvar o arquivo em outra codificação. A causa é um editor de texto fora do padrão. Use UTF-8.
Perguntas frequentes
Preciso converter o SRT para VTT para enviar ao YouTube?
Não. A página de formatos do YouTube lista .srt e .vtt entre os aceitos. A conversão é necessária para o elemento track, que usa WebVTT.
Posso ter legendas em mais de um idioma no mesmo vídeo?
Pode. No HTML, cada idioma ganha um track, e o exemplo acima tem dois. Na plataforma citada, o passo ADD LANGUAGE pede o idioma da legenda. O tutorial do MDN usa três arquivos, em inglês, alemão e espanhol.
A ajuda do YouTube explica o que muda entre “With timing” e “Without timing”?
Não. A página consultada só diz que as duas opções existem. Se a dúvida importa, confira a tela no próprio YouTube Studio.
O vídeo precisa ficar no mesmo endereço da legenda?
O MDN exige a mesma origem para o arquivo de legenda, e não para o vídeo. A página não descreve em detalhe o atributo crossorigin, que libera outra origem. Consulte a referência dele se precisar.
Fontes
- MDN Web Docs (Mozilla). <track> HTML embed text track element - HTML | MDN. Consultado em 19 de novembro de 2026.
- MDN Web Docs (Mozilla). Adding captions and subtitles to HTML video - Media | MDN. Consultado em 19 de novembro de 2026.
- Google (Ajuda do YouTube). Add subtitles & captions - YouTube Help. Consultado em 19 de novembro de 2026.
- Google (Ajuda do YouTube). Supported subtitle and closed caption files - YouTube Help. Consultado em 19 de novembro de 2026.
- W3C. WebVTT: The Web Video Text Tracks Format. Consultado em 19 de novembro de 2026.
Continue lendo
- O que é um arquivo VTT (WebVTT) e quando usar Veja o que é um arquivo VTT (WebVTT): o cabeçalho, os blocos de legenda, as notas, o estilo e a posição, e quando ele é a melhor escolha.
- SRT ou VTT: qual formato de legenda escolher Compare SRT e VTT em uma tabela: separador dos milissegundos, cabeçalho, estilo, posição e compatibilidade, e veja uma regra prática para escolher.
- Como converter SRT em VTT e VTT em SRT Passo a passo para converter SRT em VTT e VTT em SRT sem estragar a legenda: o que trocar, o que se perde e como fazer isso no editor do irokod.com.
- Legenda embutida na imagem ou arquivo separado Legenda gravada na imagem ou arquivo separado: compare controle do espectador, idiomas, correção, aparência e compatibilidade, e veja uma regra para decidir.
- Arquivo de legenda que não abre: erros mais comuns A legenda não aparece ou o arquivo não abre? Siga um roteiro do sintoma à causa: extensão, linhas em branco, tempos, cabeçalho do VTT e codificação.
- Legendas em videoaulas: como planejar e fazer Roteiro para legendar uma videoaula que você gravou: termos técnicos, tempo de leitura com slides, revisão, transcrição e cuidados ao publicar o arquivo.