Resposta rápida

O VLibras é gratuito, oficial e instala no site com uma linha de script. Mas o próprio mantenedor pede que ele não seja usado como substituto de intérprete em aula, curso, audiência, propaganda ou produção audiovisual — e, na norma brasileira, janela de Libras é recomendação de Nível AAA, não requisito.

O roteiro é quase sempre o mesmo. Chega a cobrança de acessibilidade — de um cliente, de um edital, de um relatório interno —, alguém pesquisa, encontra o VLibras, instala o widget em dez minutos e o assunto é considerado encerrado. A ferramenta é ótima, é oficial e é de graça. O encerramento é que é falso.

Duas informações desfazem o engano, e as duas estão em fonte oficial. A primeira é do próprio mantenedor, que pede que a ferramenta não seja usada de forma substitutiva em curso, aula, seminário, audiência, propaganda eleitoral, produção audiovisual e anúncio. A segunda é da norma brasileira de acessibilidade web, que classifica janela de Libras como recomendação, enquanto legenda e audiodescrição são requisitos.

Este artigo entrega as duas coisas, nessa ordem: primeiro o como instalar, que é o que você veio buscar; depois a leitura honesta de o que fica coberto e o que continua descoberto.

Como este artigo foi apurado. Todas as citações, números e listas vêm da página oficial do VLibras no Portal Gov.br e do Manual de Instruções da Ferramenta VLibras Widget, lidos em 27/09/2026; do GitHub da organização spbgovbr-vlibras, consultado na mesma data; e do texto da ABNT NBR 17225:2025. Nada aqui foi copiado de tutorial de terceiro.

Como colocar o VLibras no site (o caminho oficial)

Para o site, o item da suíte é o Widget VLibras, e a instalação é uma linha. Este é o código da documentação oficial, na forma mínima:

<script src="https://vlibras.gov.br/app/vlibras-plugin.js"></script>

A documentação diz que o script pode ser adicionado em qualquer parte da página HTML e que a ferramenta se inicializa sozinha, sem chamada adicional. Se você quiser controlar avatar, posição e personalização, a forma documentada é instanciar o widget explicitamente:

<script src="https://vlibras.gov.br/app/vlibras-plugin.js"></script>
<script>
  new window.VLibras.Widget({
      rootPath: 'https://vlibras.gov.br/app',
      personalization: 'https://vlibras.gov.br/config/default_logo.json',
      avatar: 'random',
      position: 'R',
  });
</script>

Se o seu site tem Content Security Policy, esta parte não é opcional. A documentação oficial pede o seguinte:

Content-Security-Policy: frame-src https://vlibras.gov.br; font-src https://vlibras.gov.br https://cdn.jsdelivr.net;

E aqui vale um detalhe de arquitetura que nenhum tutorial menciona, e que explica a segunda diretiva acima. Ao pedir o script oficial, o servidor do gov.br responde com um redirecionamento (HTTP 302) para o CDN público jsDelivr, que entrega o arquivo a partir de uma versão fixada do repositório vlibras-portal (verificado em 27/09/2026). Em termos práticos: a sua página passa a depender de um CDN de terceiro, além do domínio do governo. Se a rede da empresa filtra CDN externo, o widget não desenha — e essa é uma das causas reais do "o VLibras não está funcionando".

Nota de versão, para não inventar número. O manual do Widget se identifica como versão 7.0.0. O arquivo que o script oficial entrega hoje vem de uma tag mais recente do repositório do portal. São duas numerações diferentes — a do manual e a do artefato servido —, e por isso não afirmamos aqui "a versão atual do widget é X". Se o número importa para o seu inventário de software, confira no momento da instalação.

Nos ambientes em que a pergunta mais aparece:

  • WordPress: não há plugin oficial do governo. O script entra no footer do tema (idealmente num tema-filho) ou por um plugin genérico de inserção de código — é o mesmo script acima.
  • React, Vue, Angular: também é o mesmo script, mas o quando importa. Em aplicação de página única, código executado antes de a página existir não encontra onde se anexar; garanta que o script rode depois da montagem.
  • Site estático: uma linha antes de fechar o </body> e está feito.

Além do widget, a página oficial oferece para download — lista conferida em 27/09/2026 — Plugin Google Chrome, Plugin Mozilla Firefox, Instalador Windows (7 ou superior), Instalador Linux (64 bits), Aplicativo Android, Aplicativo iOS e — o item que quase nenhum tutorial cita — o Addon VLibras NVDA, que integra a suíte ao leitor de tela mais usado no Windows. Para quem desenvolve, há ainda documentação de páginas web, manuais de Windows e Linux, o modelo 3D do avatar e guia de desenvolvimento.

Repare na diferença de sujeito, porque ela é a chave do artigo: os plugins de navegador e os aplicativos são escolhas de quem visita. O widget é a decisão de quem publica. Um site acessível não pode depender de o visitante ter instalado extensão.

O que é a suíte — e o que o widget de fato traduz

A definição é da própria página oficial:

"A suite VLibras é um conjunto de ferramentas gratuitas e de código aberto que traduz conteúdos digitais (texto, áudio e vídeo) em Português para Libras, tornando computadores, celulares e plataformas Web mais acessíveis para as pessoas surdas."

O VLibras é fruto de uma parceria entre o Ministério da Gestão e Inovação em Serviços Públicos, por meio da Secretaria de Governo Digital; o Ministério dos Direitos Humanos e da Cidadania, por meio da Secretaria Nacional dos Direitos da Pessoa com Deficiência; e a Universidade Federal da Paraíba, pelo Laboratório de Aplicações de Vídeo Digital (LAVID). A página registra ainda que a concepção contou com a RNP e a Câmara dos Deputados.

Agora o recorte que evita uma promessa falsa no seu site. A frase acima descreve a suíte — o conjunto, que inclui tradutor, dicionário e player. O manual do Widget, que é a peça que você instala na página, descreve a tradução de texto de páginas web: o usuário seleciona conteúdo textual e o avatar 3D sinaliza. Não há, na documentação do widget, a promessa de sinalizar o áudio dos vídeos do seu site.

Então não escreva na sua página "nossos vídeos têm Libras porque instalamos o VLibras". Além de não ser verdade, é a exata expectativa que faz o visitante surdo abrir o vídeo e não encontrar nada.

Do lado de quem usa, o manual documenta uma lista de controles mais rica do que o botão sugere: reproduzir, pausar e reiniciar, seleção de velocidade, opção de legendas, janela expandida, troca de avatar, posição e opacidade do widget, seleção de região (regionalismo), dicionário e um mecanismo de avaliação e revisão da tradução.

Sobre volume de uso, a página oficial publica: "Mais de 100 mil traduções realizadas todos os dias", "120 mil+ sites utilizam o VLibras", "90 mil frases treinadas por inteligência artificial" e "21 mil+ sinais cadastrados em nossa biblioteca". Uma ressalva honesta: a página não informa a data de apuração desses números. Eles são reproduzidos aqui como o que são — números publicados pela página oficial, lida em 27/09/2026 —, não como medição nossa nem como dado do dia.

"Código aberto" é verificável aqui: o que há no GitHub

"Código aberto" costuma ser adjetivo de release. Neste caso dá para conferir, e a conferência responde a objeção mais comum de quem decide — "e se o governo abandonar isso?" — com evidência em vez de opinião.

A organização spbgovbr-vlibras no GitHub mantém 15 repositórios públicos (consultados em 27/09/2026), entre eles vlibras-portal, vlibras-player-webjs, vlibras-web-browsers, vlibras-translator-api, vlibras-translator-text-core, vlibras-mobile-cross-platform e a família vlibras-dictionary-*. Dos 15, 8 declaram licença LGPL-3.0 — e 7 não declaram licença nenhuma, o que é um detalhe relevante se você for reaproveitar código: "a suíte é LGPL-3.0" não vale repositório por repositório.

Sobre estar vivo: vlibras-web-browsers tinha push em 24/09/2026, três dias antes desta consulta; vlibras-portal em 09/09/2026; vlibras-translator-api em 31/08/2026. Projeto ativo, portanto — não é código parado desde 2019, como boa parte dos tutoriais que ranqueiam sobre ele.

Uma coisa que não afirmamos: qual repositório entrega o widget que você instalou. Isso exigiria rastrear o artefato item por item, e não fizemos essa verificação.

O aviso que está na própria página oficial

Esta é a informação mais importante do artigo, e ela não é nossa opinião: está escrita pelo mantenedor, na página oficial, em dois blocos seguidos.

"Lembre-se: o VLibras não substitui um intérprete humano"

"Não recomendamos sua utilização substitutiva em cursos, aulas, seminários, audiências, propagandas eleitorais, produções audiovisuais, anúncios ou situações similares na internet, na televisão ou mesmo presenciais."

Página oficial do VLibras, Portal Gov.br — lida em 27/09/2026.

Leia a lista devagar: cursos, aulas, seminários, audiências, propagandas eleitorais, produções audiovisuais, anúncios. Isso cobre quase tudo que um site de conteúdo publica. A plataforma de EAD está ali. O webinário está ali. O vídeo institucional está ali. A sessão da câmara está ali, na palavra "audiências".

E o aviso precisa ser lido pelo que ele é. O mantenedor não está desqualificando o próprio produto — está dizendo para que ele serve (dar acesso a conteúdo digital, todo dia, em escala, de graça) e para que não serve (substituir intérprete em situação de comunicação formal). Ferramenta boa com escopo declarado é melhor do que ferramenta que promete tudo.

Onde o widget entra na régua técnica — e onde não entra

A norma brasileira de acessibilidade web é a ABNT NBR 17225:2025. Nela, a janela de Libras é o item 5.14.6 — "Janela de Libras está disponível em todo o conteúdo de áudio pré-gravado em mídia sincronizada" —, classificado como recomendação, ancorado no critério WCAG 1.2.6, de Nível AAA.

Na mesma Seção 5.14, são requisitos: legendas para vídeo gravado (5.14.2), legendas para áudio e vídeo ao vivo (5.14.9, Nível AA), audiodescrição para vídeo (5.14.4) e controle de áudio (5.14.7) — nada de áudio tocando sozinho por mais de 3 s sem um jeito de pausar ou silenciar. E a norma separa conformidade regular (todos os requisitos, alinhada ao Nível AA) de conformidade plena (requisitos e recomendações).

Junte as duas metades e a conta fica desconfortável: instalar o widget não atende, por si, nenhum requisito da conformidade regular. Quem instalou o VLibras e não legendou o vídeo continua fora da régua. Pior: costuma acreditar que entrou nela. E, como o widget traduz texto, ele normalmente não fecha nem o próprio 5.14.6 num site que tem vídeo.

Cuidado com a conclusão errada — e ela é fácil de tirar. "Recomendação AAA" descreve onde a janela de Libras está na escala de conformidade, não o quanto ela vale para quem precisa dela. Para a pessoa que tem Libras como primeira língua, o texto em português é um segundo idioma: para ela, a janela não é um extra: é o acesso. Legenda e Libras não são alternativas excludentes — atendem públicos diferentes, e nenhuma substitui a outra. Essa discussão está desenvolvida no nosso artigo sobre a transmissão ao vivo da câmara municipal, na seção "Legenda ou Libras?". O que a norma faz é dizer o que é exigido para declarar conformidade; ela não hierarquiza público.

O mapa completo da norma — os 146 itens, a separação entre requisito e recomendação e a Seção 5.14 item por item — está em norma ABNT de acessibilidade em site: o que a NBR 17225:2025 exige do seu site, do seu player e da sua live. Aqui ficamos só no ponto em que o widget toca a régua.

Widget de Libras não é o símbolo de acessibilidade da LBI

Antes de tudo, a ressalva que evita erro em reunião: norma técnica da ABNT não é lei. A obrigação jurídica vem da Lei Brasileira de Inclusão (Lei 13.146/2015), cujo art. 63 manda tornar acessíveis os sites mantidos por empresas com sede ou representação comercial no país, "observadas as melhores práticas e diretrizes de acessibilidade adotadas internacionalmente". A norma é a régua reconhecida para demonstrar que você seguiu essas práticas.

E há um detalhe prático do §1º do mesmo art. 63 que passa batido: além de acessível, o site precisa exibir em destaque o símbolo de acessibilidade. São duas coisas diferentes — o widget de Libras não é o símbolo de acessibilidade. É perfeitamente possível ter o avatar do VLibras no canto da tela e continuar sem cumprir o §1º, porque falta o símbolo.

"Como tirar o VLibras do site?"

Essa pergunta aparece na caixa de perguntas do Google sobre o tema, e ela merece resposta direta em vez de sermão. Remover é trivial: apague a linha de script (ou desative o plugin que a injeta).

Mas vale investigar o motivo antes, porque quase sempre ele é ajustável:

  • O botão atrapalha ou cobre algo — sobretudo no celular, onde o canto direito costuma disputar espaço com botão de WhatsApp, chat e banner de cookies. O widget documenta parâmetros de posição e opacidade: mexa neles antes de arrancar. Se você tem três botões flutuantes no mesmo canto, o problema não é o VLibras.
  • Peso da página — o script inicial é pequeno, mas o widget carrega o avatar e recursos adicionais. Se a preocupação é desempenho, meça a sua página antes e depois, em vez de decidir por impressão.
  • "Não está funcionando" — antes de remover, confira o CSP, a ordem de carregamento no seu framework e o acesso ao CDN externo (as três causas da seção de instalação).

E, se a remoção for para valer, uma última consideração: você não está removendo a acessibilidade do site, porque o widget nunca foi ela. O que precisa entrar no lugar não é outro widget: é a lista de requisitos — legenda no vídeo gravado, legenda na transmissão ao vivo, audiodescrição e controle do áudio que toca sozinho.

O custo do intérprete humano — contado por quem contratou

O tema deste artigo nasceu de uma conversa concreta. Ao transmitir um debate eleitoral para prefeito, a equipe teve de contratar intérprete de Libras e encontrou o que quem já fez isso reconhece: hora caríssima ao vivo, poucos profissionais disponíveis e — o detalhe que mais diz — o horário e o dia do debate foram condicionados à agenda do intérprete.

É dessa escassez que nasce a esperança de que a tecnologia resolva, e é compreensível. Vale registrar, com a data e o dono da fala: em setembro de 2024, Josimar Machado, CEO da JMV Technology, lendo a página oficial do VLibras ao vivo pela primeira vez, reagiu ao aviso dizendo que na opinião dele a ferramenta teria de evoluir para substituir, porque tornaria o acesso barato e o poder público não daria conta de um intérprete por escola.

A opinião está registrada; a orientação oficial, ao lado dela, continua sendo a que vale para a sua decisão de hoje: o VLibras não substitui intérprete humano, e o mantenedor não recomenda uso substitutivo justamente em situações como aquele debate. Custo alto e escassez são problemas reais — e nenhum dos dois transforma tradução automática em intérprete.

Uma nota sobre o que não afirmamos: a conversa menciona obrigatoriedade legal de intérprete de Libras naquele contexto eleitoral. Não verificamos essa obrigação em fonte primária e, por isso, ela não é reproduzida aqui como afirmação jurídica.

Assista ao episódio completo

Este texto nasceu do episódio "JMV Automate: agentes individuais de IA — Acessibilidade, EP. 4", do podcast Café & Tech, publicado pelo canal da JMV Technology em 12 de setembro de 2024 (59min58s), com Mário Sérgio, consultor de soluções da JMV, e Josimar Machado, CEO da JMV Technology. O episódio trata de acessibilidade num ângulo bem mais largo — automação residencial, assistentes de voz, IA aplicada à inclusão — e este artigo desenvolve só um trecho dele: os minutos em que o VLibras entra na conversa. Vale assistir inteiro.

Trechos citados do episódio (transcrição revisada)

34:03 — "Acabei de ver aqui uma iniciativa do governo federal que eu não conhecia, chama VLibras […] é open source, de código aberto, um conjunto de ferramentas gratuitas que traduz os conteúdos digitais — texto, áudio e vídeo — em português para Libras, tornando computadores, celulares e plataformas web mais acessíveis. Não conheço. Tecnicamente, vou até pesquisar sobre isso." — a descoberta da ferramenta, ao vivo, na página oficial.

34:45 — "Aí vem: 'lembre-se, o VLibras não substitui intérprete humano'. Aqui eu já acho que é o erro de governo, né — tem que evoluir para substituir, porque vai tornar algo barato. O governo vai dar conta de um intérprete de Libras para cada uma das escolas públicas que existe? Não vai." — a opinião do CEO, de 12/09/2024, sobre o aviso oficial. A orientação do mantenedor permanece a que consta na página.

30:22 — "A gente foi fazer a live do debate para prefeito e teve que contratar uma pessoa para fazer Libras. […] Era caro, a hora da pessoa era cara para fazer ao vivo. E a gente não tem a quantidade de profissionais que seria preciso — foi uma dificuldade encontrar agenda; a gente até condicionou o horário e o dia do debate à disponibilidade da pessoa." — o custo e a escassez, em primeira pessoa.

35:17 — "Se você tem um portal de notícia, verificar se ele é inclusivo; se você tem um EAD, verificar se as suas aulas são inclusivas; se você faz um evento, um webinário, uma live, verificar se ela é inclusiva." — a lista de verificação que a NBR 17225 formalizou seis meses depois.

Transcrição automática do YouTube, revisada para corrigir erros de reconhecimento de fala (o áudio grafa "JMV" como "DMV/GMV" e "Josimar" como "Josmar") e pontuada para leitura. Falas de 12/09/2024.

Ver também

Quer resolver o que o widget não resolve — legenda no vídeo, controle do áudio, marcação da página — com acesso real ao seu ambiente? Fale com a gente pelo WhatsApp (11) 4063-8923.