O embed do Discord não está aparecendo ou não está atualizando
O Discord busca a página uma vez, lê as tags no HTML do servidor e armazena a prévia em cache por cerca de 30 minutos. Ele nunca executa o seu JavaScript.
Última atualização
Solução rápida
Verifique a página com o verificador de meta tags.
Disponibilize as tags no HTML, com uma resposta 2xx que termine em até 10 segundos.
Adicione twitter:card summary_large_image para uma imagem grande.
Teste no Depurador de Embeds do Discord ou publique com ?v=2.
Por que o embed do Discord está ausente ou desatualizado
As tags vêm do JavaScript. O Discord não executa nenhum código, portanto, as tags adicionadas após o carregamento nunca são vistas.
A resposta não é 2xx. Redirecionamentos funcionam até 5 vezes, mas a resposta final deve ser 2xx com
text/html.A busca é muito lenta. Toda a busca, incluindo a medição de imagens e vídeos, deve ser concluída em até 10 segundos.
A proteção contra bots bloqueia o Discordbot. As páginas são buscadas com
Discordbot/2.0no user-agent.O Discord armazenou em cache o embed antigo. As prévias ficam em cache por cerca de 30 minutos.
Como corrigir
Leia as tags com o verificador de meta tags.
Renderize
og:title,og:descriptioneog:imageno servidor.Adicione
og:image:widtheog:image:heightpara que o Discord não precise buscar a imagem para medi-la.Defina
twitter:cardcomosummary_large_imagese desejar a imagem grande abaixo do texto.Permita o Discordbot na sua CDN e, em seguida, teste no Embed Debugger ou envie a URL com
?v=2.
Tags que o Discord lê
og:titleoutwitter:title, cortado em 70 bytesog:descriptionoutwitter:description, cortado em 350 bytesog:site_nameexibido acima do títuloog:imageoutwitter:image; duas ou mais tags og:image criam uma galeria de até 4theme-colorpara a barra de destaque, como #RRGGBB ou #RRGGBBAAtwitter:cardeog:typepara o layout
Regras de tamanho de imagem
Formatos: PNG, GIF, JPG, WebP e AVIF
Declare og:image:width e og:image:height
Até 4 imagens por link
Toda a busca em até 10 segundos e 50 MB
Não verificado: o Discord não publica um tamanho de pixel mínimo ou recomendado. 1200 x 630 px é uma escolha segura.
Como forçar uma atualização
O Discord armazena prévias em cache por cerca de 30 minutos. Para ver as alterações agora, compartilhe a URL com uma nova query string como ?v=2 ou verifique-a no Embed Debugger. A ferramenta de atualização mostra o passo a passo para cada aplicativo.
Fontes
Perguntas Frequentes
Por que o Discord mostra uma imagem pequena em vez de uma grande?
Sem as tags de layout, o Discord exibe o texto com uma imagem pequena. Defina twitter:card como summary_large_image para usar o layout grande.
Por quanto tempo o Discord mantém embeds em cache?
Cerca de 30 minutos, de acordo com a documentação para desenvolvedores do Discord. Use uma nova query string para testar as alterações.
O Discord executa JavaScript quando cria uma prévia incorporada (embed)?
Não. O Discord não executa nenhum código, portanto as tags devem estar no HTML que o seu servidor envia.
Verifique sua página e atualize a prévia
Cole sua URL no verificador gratuito para ver as tags exatas que cada aplicativo lê. Assim que as tags estiverem corretas, use a ferramenta de atualização para limpar a pré-visualização antiga.
Guias relacionados
A prévia de links do Slack não está funcionando ou não está atualizando
O Slack expande links com um bot que lê tags do oEmbed, Open Graph e Twitter Card. Os resultados ficam armazenados em cache no Slack por cerca de 30 minutos.
O card do X (Twitter) não está aparecendo ou não está atualizando
O X cria o card a partir das tags twitter:, usando as tags og: como alternativa. Não há mais um validador que atualize o cache, então a solução é usar tags corretas acompanhadas de uma nova URL.
A prévia do link do WhatsApp não está funcionando ou não aparece
O WhatsApp tem limites rígidos: a tag head precisa estar nos primeiros 300 KB do HTML e a imagem deve ter menos de 600 KB. Se desrespeitar algum deles, você terá uma miniatura pequena ou nenhuma prévia.