Gerador de Código de Incorporação do YouTube
Cole uma URL ou ID de vídeo do YouTube e gere um iframe embed personalizável. Pré-visualização ao vivo ao ativar autoplay, loop, controles, tempos de início/fim, dimensões e modo de privacidade. Copie um código de incorporação de uma linha, pronto para colar.
Funciona com URLs de watch, links curtos <code>youtu.be</code>, URLs <code>/shorts/</code> ou apenas um ID de vídeo com 11 caracteres.
Cole uma URL
Cole uma URL de watch, link /shorts/, link curto youtu.be ou apenas o ID de vídeo com 11 caracteres. Extraímos o ID e carregamos a pré-visualização ao vivo.
Personalize a reprodução
Ative autoplay, loop e controles. Defina os tempos de início/fim em segundos ou MM:SS. Escolha largura × altura com trava 16:9. Selecione o modo de privacidade.
Copiar e colar
Clique em Copiar para pegar o iframe de uma linha. Cole em HTML, Markdown, um CMS ou editor de texto rico. O player carrega no primeiro render.
Cole qualquer URL de watch do YouTube, link youtu.be, URL /shorts/ ou ID de vídeo com 11 caracteres e esta ferramenta gera um código de incorporação <iframe> personalizável. Ative autoplay, loop e controles, defina os tempos de início/fim, escolha largura × altura (trava 16:9 disponível) e selecione o modo de privacidade (youtube-nocookie.com) ou padrão. Pré-visualização ao vivo, código pronto para copiar, sem upload, sem cadastro.
O que é um gerador de código de incorporação do YouTube?
Um código de incorporação do YouTube é um pequeno snippet <iframe> que carrega o player do YouTube na sua própria página. O navegador busca o player no YouTube, reproduz o vídeo dentro do frame e repassa os controles do usuário pela IFrame Player API do YouTube. A URL src do frame — https://www.youtube.com/embed/{videoId} — é a única parte que o YouTube realmente lê. Todo o restante (autoplay, loop, controles, início/fim) é adicionado como parâmetros de query string que o player verifica ao carregar.
Este gerador cria esse snippet para você. Cole uma URL de watch, link curto youtu.be, link /shorts/ ou um ID de 11 caracteres; ative os toggles para as opções de reprodução desejadas; e copie o resultado. A saída é um único iframe — sem JavaScript, sem loader de terceiros, nada para instalar. Cole em HTML, Markdown, campo de texto rico de um CMS, página do Notion, post do Substack ou onde quer que embeds sejam aceitos, e o player carrega no primeiro render.
Por que personalizar um embed?
Os padrões funcionam bem quando um embed é o foco da página, mas raramente são adequados para vídeos hero, plataformas de cursos, quiosques ou sites de marketing onde o vídeo é um conteúdo de suporte. Autoplay + mute + loop é a receita padrão para um hero de fundo. Tempo de início pula introduções para que uma citação chegue ao momento certo. Controles ocultos fazem o embed parecer nativo em vez de um widget do YouTube. Modo de privacidade adia a escrita de cookies até que o usuário reproduza ativamente, o que simplifica os fluxos de consentimento sob GDPR e regras de ePrivacy. A maioria dessas opções não está exposta no diálogo de cópia de compartilhamento do YouTube, por isso um gerador separado é útil.
Privacidade do embed: quais cookies um iframe do YouTube deposita
Um embed do YouTube é uma chamada de rede ao Google. Mesmo antes de o usuário clicar em play, o iframe padrão youtube.com/embed/{id} carrega JavaScript e ativos de imagem de googlevideo.com e define alguns cookies de sessão — VISITOR_INFO1_LIVE, YSC e alguns cookies de analytics. O host com privacidade aprimorada (youtube-nocookie.com) adia tudo isso até que o usuário efetivamente inicie a reprodução. Para banners de consentimento que bloqueiam rastreadores por padrão, essa é a diferença entre um embed que carrega no primeiro render e um que precisa de um clique. Usamos nocookie como padrão porque a maioria das páginas se beneficia disso; mude para youtube.com apenas quando precisar especificamente do comportamento padrão do YouTube.
Por que o autoplay só funciona quando está sem som?
Os navegadores bloqueiam o autoplay com áudio por padrão. Chrome, Safari, Firefox e Edge aplicam uma política de engajamento de mídia: um vídeo só pode reproduzir automaticamente se estiver sem som ou se o usuário já tiver interagido com o site de forma significativa. A consequência prática para embeds é que autoplay=1 funciona de forma confiável apenas quando combinado com mute=1. Se você desmarcar o mute com o autoplay ativado, esta ferramenta exibe um aviso e a pré-visualização ao vivo fará o autoplay silencioso em alguns navegadores e não funcionará em outros — exatamente o que os visitantes reais experimentarão. A solução é uma de duas: mantenha o mute ativo ou desative o autoplay e deixe o usuário pressionar play.
youtube-nocookie.com vs youtube.com
Ambos os hosts servem o mesmo player e o mesmo vídeo. A diferença está no comportamento dos cookies. youtube.com define um pequeno conjunto de cookies de sessão e analytics no primeiro carregamento do frame — mesmo que o usuário nunca clique em play. youtube-nocookie.com adia a escrita de cookies até que o usuário inicie explicitamente a reprodução. Para uma página que exibe principalmente o player mas onde a maioria dos visitantes não assiste, o host nocookie é o padrão correto — menos cookies por visitante, fluxos de consentimento mais simples sob GDPR/ePrivacy e comportamento idêntico quando um usuário realmente reproduz o vídeo. Não há diferença de qualidade, nenhum recurso de reprodução que você perde e nenhuma penalidade de SEO ao usar qualquer um dos hosts. Esta ferramenta usa nocookie como padrão por esse motivo.
Parâmetros obsoletos e o que os substitui
Alguns parâmetros de embed que você verá em snippets mais antigos estão obsoletos. showinfo=0 e rel=0 foram descontinuados em 2018 — o player ignora ambos. cc_load_policy=1 ainda funciona para forçar legendas, mas o YouTube também lê a preferência da conta do espectador, então não é uma garantia. O flag enablejsapi=1 não está obsoleto, mas é útil apenas se você está chamando a IFrame Player API a partir de JavaScript na página hospedeira; para um embed estático é ruído. Omitimos todos eles do snippet gerado por padrão — menos bytes, menos surpresas e nada que o player irá ignorar.
O que este gerador não inclui
Omitimos deliberadamente algumas opções presentes em geradores de embed mais antigos. Os parâmetros obsoletos showinfo, rel e ajustes de cor avulsos (color=red/white) foram removidos — o player não os lê mais. O flag fs=0 para ocultar o botão de tela cheia raramente é útil em sites reais, por isso não está exposto; você pode editá-lo manualmente no código gerado se precisar. enablejsapi=1 só importa quando você está controlando o player via JavaScript na sua própria página, o que é um fluxo separado de um embed estático e está fora do escopo aqui. Legendas estão disponíveis via cc_load_policy, mas o padrão é a preferência da conta do espectador — adicionar uma caixa de seleção aqui induziria os usuários ao erro, como se fosse uma chave garantida, então a deixamos de fora.
Parâmetros de embed em resumo
Estes são os parâmetros que a IFrame Player API realmente lê. Qualquer coisa não listada aqui é ignorada ou obsoleta.
| Parâmetro | O que faz | Quando usar | Padrão |
|---|---|---|---|
autoplay | Inicia o vídeo automaticamente assim que o iframe carrega. | Loops de fundo, vídeos hero, demo reels — sempre combinado com mute, caso contrário o navegador bloqueia. | 0 (off) |
mute | Inicia o vídeo com o áudio silenciado; o usuário pode ativar o som pelos controles do player. | Sempre quando o autoplay está ativo. Às vezes útil sozinho para tornar uma affordance de hover-to-play menos intrusiva. | 0 (off) |
loop | Reproduce o vídeo desde o início quando termina. Requer o parâmetro <code>playlist</code> para loops de vídeo único. | Vídeos hero, fundos animados, exibições em quiosque onde o vídeo roda em ciclo contínuo. | 0 (off) |
controls | Exibe ou oculta a interface do player (play/pause, barra de progresso, volume, configurações). | Ocultar para loops de autoplay ou embeds artísticos onde a UI compete com o design da página. | 1 (visible) |
start | Inicia a reprodução no offset de segundos indicado, em vez de desde o início. | Linkar para um momento específico — citar uma palestra, referenciar um passo de tutorial, pular uma introdução. | — |
end | Para a reprodução no offset de segundos indicado a partir do início do vídeo. | Incorporar um único segmento de uma palestra ou transmissão mais longa — combine com <code>start</code> para recortar dos dois lados. | — |
| host | Alterna o host do iframe entre <code>youtube.com</code> e <code>youtube-nocookie.com</code>. Mesmo player, comportamento de cookie diferente. | Sites preocupados com privacidade, fluxos de consentimento GDPR, páginas onde a maioria dos visitantes nunca clica em play. | youtube-nocookie.com |
Cada linha corresponde a um parâmetro de URL no <code>src</code> do iframe. Parâmetros definidos com seu valor padrão são omitidos do código gerado para manter o snippet pequeno.
Usos comuns
- Posts de blog e artigos: incorpore um vídeo em um timestamp específico usando o parâmetro start para pular introduções e levar os leitores direto ao momento citado.
- Páginas de marketing e landing pages: use um vídeo hero de fundo silenciado, com autoplay e loop para criar atmosfera sem o áudio competir com o texto.
- Documentação e tutoriais: incorpore um segmento recortado com os tempos de início e fim definidos, para que cada etapa tenha link para sua própria região do vídeo.
- Sites com foco em privacidade: use o host youtube-nocookie para que os embeds carreguem sem definir cookies de rastreamento até o usuário pressionar play ativamente.
- Quiosques e sinalização digital: desative os controles e faça o loop de um único vídeo para uma exibição limpa e minimalista.
- Plataformas de cursos e embeds em LMS: adicione um iframe dimensionado em uma página de aula onde você não pode executar scripts de terceiros, mas HTML simples é permitido.
Como isso se compara ao código de incorporação oficial do YouTube
O próprio diálogo de compartilhamento do YouTube fornece um código de incorporação, mas é uma cópia única: você obtém um snippet fixo com um tamanho padrão difícil de personalizar (560×315), uma caixa de seleção para o tempo de início e um toggle de modo de privacidade. Qualquer outra coisa — alternar controles, fazer loop de um único vídeo, definir um tempo de fim, escolher um tamanho não padrão — precisa ser editada manualmente ou configurada pela IFrame Player API. O código oficial também é mais verboso (atributos extras, uma lista allow um pouco mais antiga) do que o que o player realmente requer.
Este gerador oferece todos os parâmetros que o player reconhece em um único formulário, com uma pré-visualização ao vivo que atualiza conforme você alterna. A saída é a superfície mínima que reflete suas escolhas: os padrões são omitidos, os parâmetros obsoletos são ignorados e os atributos do iframe correspondem à especificação moderna de allow. A saída de uma linha vai direto para a área de transferência para colar limpo em JSX, Markdown e CMSes que não aceitam atributos de múltiplas linhas; a visualização de múltiplas linhas é puramente para leitura humana.
Ferramentas YouTube relacionadas
- Baixar miniaturas do YouTube — Baixe as miniaturas de um único vídeo em todas as resoluções, do padrão ao Max HD.
- Baixar miniaturas do YouTube Shorts — Igual ao baixador de miniaturas, mas otimizado para URLs /shorts/ com o selo SHORTS.
- Comparar miniaturas do YouTube — Coloque as miniaturas de dois vídeos lado a lado em todas as resoluções. Útil para pesquisa A/B e análise de concorrentes.
FAQ
Isso funciona para vídeos privados ou não listados?
Vídeos não listados funcionam — qualquer pessoa com o link, incluindo o src do iframe, pode assistir. Vídeos privados não são incorporados publicamente; eles exigem que o espectador esteja conectado a uma conta Google adicionada à lista de permissões do vídeo, e o iframe exibirá uma mensagem de "vídeo indisponível" para os demais. Se você incorporar um vídeo privado e seus visitantes não estiverem na lista de permissões, eles não verão nada.
Por que não há um botão de download no player?
Os termos de serviço do YouTube proíbem downloads a partir de players incorporados, e a IFrame API não expõe um hook para isso. A UI de download dentro do próprio player é restrita a usuários do YouTube Premium em youtube.com — nunca aparece em embeds de terceiros. Se precisar hospedar uma cópia para download, faça o upload do vídeo para seu próprio site ou um serviço que suporte links diretos para arquivos.
Como faço o embed responsivo no celular?
O iframe de tamanho fixo gerado por esta ferramenta é o padrão do YouTube, mas não encolhe em telas pequenas. A solução comum é envolver o iframe em um container com position: relative; padding-bottom: 56.25%; height: 0; e estilizar o iframe com position: absolute; top: 0; left: 0; width: 100%; height: 100%;. Os 56.25% são 9 ÷ 16 — é assim que você preserva a proporção 16:9 em qualquer largura. Remova os atributos width e height do iframe ao fazer isso.
Posso incorporar em um timestamp específico sem usar o parâmetro start?
Você pode — adicione ?t=120 a uma URL de watch no YouTube e a página pula para 2 minutos, mas o player iframe ignora t. Para embeds, o parâmetro é start (em segundos). Este gerador aceita 120, 2:00 ou 0:02:00 no campo Iniciar em e converte automaticamente. O parâmetro de fim funciona da mesma forma.
Qual é a diferença entre o modo de privacidade e um embed sem anúncios?
O modo de privacidade (youtube-nocookie.com) só muda quando o YouTube deposita cookies — aguarda o início da reprodução. Não oculta anúncios e não impede o YouTube de coletar dados assim que o usuário clica em play. Não existe flag de embed que desative anúncios em uma conta gratuita; assinantes do YouTube Premium veem reprodução sem anúncios em seus próprios acessos, mas o embed em si não pode suprimir anúncios para outros espectadores.
Por que a pré-visualização ao vivo sempre usa youtube-nocookie independentemente do toggle?
Para que navegar nesta página não deposite cookies do YouTube quando você não pediu explicitamente. O toggle de privacidade controla apenas o código gerado — o snippet que você vai copiar. O iframe de pré-visualização nesta página é fixo como youtube-nocookie.com; a configuração do toggle é o que fica registrado no código que você leva consigo.
O parâmetro loop funciona em um único vídeo?
Sim, mas com uma peculiaridade: loop=1 sozinho é ignorado silenciosamente pelo player. Para fazer o loop de um único vídeo, você também precisa de playlist={videoId} — o mesmo ID do vídeo, repetido. Esta ferramenta adiciona o parâmetro playlist automaticamente quando você ativa o loop, para que o código gerado faça o loop corretamente sem você precisar lembrar do truque.
Em números
- Mínimo de 200×113: abaixo desse tamanho, o player do YouTube oculta seus próprios controles e exibe um fallback menor. Acima disso, qualquer dimensão até 4096px em cada lado renderiza corretamente. O padrão histórico do YouTube para embed é 560×315; o 16:9 se mantém em qualquer par que satisfaça
altura = largura × 9 ÷ 16. - ~310 bytes por snippet: o iframe de uma linha gerado tem entre cerca de 280 e 360 bytes dependendo das opções. Por comparação, um embed padrão do diálogo de compartilhamento do YouTube tem cerca de 420 bytes porque inclui atributos (
referrerpolicy,titlecompleto) que não são estritamente necessários. - 2 hosts, 7 parâmetros: dois hosts de iframe (
youtube.com,youtube-nocookie.com) e sete parâmetros que o player realmente lê (autoplay,mute,loop,playlist,controls,start,end). Qualquer coisa além disso é obsoleta ou só útil pela IFrame JavaScript API.