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.

Por irokod.com Publicado em 7 min de leitura Legendas nos seus vídeos

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

  1. 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.
  2. 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.
  3. 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.

  1. Entre no YouTube Studio.
  2. No menu da esquerda, escolha Subtitles.
  3. Selecione o vídeo.
  4. Clique em ADD LANGUAGE e escolha o idioma.
  5. Em Subtitles, clique em ADD.
  6. 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.

  • kind diz como a trilha será usada. Os valores são subtitles, captions, descriptions, chapters e metadata. Se o atributo for omitido, vale subtitles.
  • src aponta 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 o video tiver o atributo crossorigin.
  • srclang informa o idioma do texto, com uma etiqueta de idioma válida. Quando kind é subtitles, ele precisa estar presente.
  • label é o título legível que o navegador mostra ao listar as trilhas.
  • default liga a trilha, a menos que as preferências da pessoa apontem outra. Use em apenas um track de 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 track para 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 default em duas trilhas. A causa é copiar o bloco sem revisar. Só uma trilha pode ter o atributo.
  • Esquecer o srclang em subtitles. A causa é achar que o label basta. O idioma é obrigatório nesse caso.
  • Guardar o .vtt em outro endereço. A causa é hospedar os arquivos em lugares diferentes. A origem deve ser a mesma da página, ou o video precisa de crossorigin.
  • 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

  1. MDN Web Docs (Mozilla). <track> HTML embed text track element - HTML | MDN. Consultado em 19 de novembro de 2026.
  2. MDN Web Docs (Mozilla). Adding captions and subtitles to HTML video - Media | MDN. Consultado em 19 de novembro de 2026.
  3. Google (Ajuda do YouTube). Add subtitles & captions - YouTube Help. Consultado em 19 de novembro de 2026.
  4. Google (Ajuda do YouTube). Supported subtitle and closed caption files - YouTube Help. Consultado em 19 de novembro de 2026.
  5. W3C. WebVTT: The Web Video Text Tracks Format. Consultado em 19 de novembro de 2026.

Continue lendo