Pourquoi les aperçus des liens Discord ne s'affichent pas : causes et correctifs
Discord l'aperçu du lien n'apparaît pas ?
Les causes les plus courantes sont les intégrations désactivées, les métadonnées Open Graph manquantes ou inaccessibles, ou Discord l'impossibilité de récupérer la page ou l'image. Vérifiez d'abord l'URL avec un aperçu OG / Discord vérificateur de liens, puis travaillez sur les paramètres du côté Discord ci-dessous.
Commencez ici
- Décidez dans quel cas vous vous trouvez : afficher le lien de quelqu'un d'autre vs être propriétaire du site Web.
- Si les liens no sont prévisualisés pour vous, n'importe où, il s'agit presque toujours d'un client ou d'un paramètre d'autorisation, et non du site Web.
- Si la même URL est affichée sur un serveur et pas sur un autre, cochez Embed Links sur ce canal ou ce rôle.
- Si l'URL n'est jamais prévisualisée pour personne, récupérez ce que
Discordbotverrait : des balises dans le HTML brut, HTTPS, pas de défi de robot.
Si vous essayez simplement de voir le lien de quelqu'un d'autre
Vous ne pouvez pas corriger les balises méta d’un autre site. Vous pouvez uniquement modifier ce que Discord est autorisé à afficher you, ou ce que ce canal permet d'être automatiquement intégré.
1. Votre client cache les aperçus du site Web
Discord a un paramètre utilisateur qui désactive l'intégration automatique du site Web. Sur le bureau, il se trouve sous Paramètres utilisateur → Chat ou Texte et images, avec une étiquette similaire à « Afficher les intégrations et prévisualiser les liens du site Web ». Si cette option est désactivée, vous verrez des URL simples même lorsque tout le monde verra une carte.
2. Le message a volontairement supprimé l'intégration
Mettre une URL entre crochets indique à Discord de ne pas l'intégrer automatiquement :
<https://example.com/page>
Si le message ressemble à cela, l'aperçu est supprimé pour tout le monde et non interrompu.
3. La chaîne ou le rôle refuse Embed Links
L'autorisation EMBED_LINKS de Discord est documentée comme suit : les liens envoyés par les utilisateurs avec cette autorisation seront automatiquement intégrés. Vérifiez les autorisations de la chaîne pour @everyone, le rôle de l'affiche et le membre spécifique. Un refus sur ce canal dépasse une autorisation à l'échelle du serveur.
Si vous pouvez publier une URL publique bien connue (par exemple un article Wikipédia) et qu'elle est intégrée, la chaîne fonctionne bien et le site d'origine est le problème.
4. Une seule personne est concernée
Demandez à quelqu'un d'autre sur la même chaîne. S'ils voient la carte et pas vous, il s'agit d'un paramètre client, d'une application obsolète ou d'un cache local – et non de Open Graph.
Si vous êtes le propriétaire du site Web
Discord récupère l'URL avec son robot (Discordbot, souvent Discordbot/2.0). Il lit les balises méta HTML. Il n'exécute pas votre JavaScript côté client. Si les balises sont injectées uniquement après l'hydratation de React, Discord voit une coquille vide.
1. Confirmez que les balises existent dans le HTML brut
Vous voulez au moins :
<meta property="og:title" content="Your Title" />
<meta property="og:description" content="A short description" />
<meta property="og:image" content="https://yoursite.com/image.jpg" />
<meta property="og:url" content="https://yoursite.com/page" />
Utilisez les URL absolues https:// pour l'image. Les chemins relatifs comme /og.png échouent souvent. Vérifiez avec Proovd ou le Discord vérificateur d'aperçu des liens — ces outils affichent les balises qu'un robot peut analyser, et non ce que le propre cache de Discord stocke actuellement.
Discord ne publie pas de spécifications OG officielles complètes. En pratique, il utilise des balises Open Graph pour l'intégration. Ne comptez pas uniquement sur twitter:image.
2. Assurez-vous que Discordbot peut récupérer la page et l'image
- L'URL HTML et l'URL de l'image doivent renvoyer un succès (généralement 200), pas un mur de connexion, 403 ou un défi Cloudflare « Juste un instant… ».
- Bot Fight Mode et les règles WAF similaires traitent les robots d'exploration comme des robots. Cela bloque Discord de la même manière qu'il bloque Slack et Meta. Voir Cloudflare blocage des aperçus de liens.
- Autoriser Discordbot dans
robots.txtvaut toujours la peine ; une page de défi devant l'origine masquera toujours les balises.
3. Taille de l’image – ce que nous savons réellement
Discord ne publie pas de règle stricte « minimum 300×300 ou pas d'intégration » dans sa documentation sur les autorisations des développeurs. Ce que nous savons en exécutant des aperçus dans Proovd : utilisez un format JPEG ou PNG volumineux et accessible via HTTPS. 1200×630 est une taille sûre car elle fonctionne également sur d'autres plates-formes. Conservez le fichier bien en dessous des limites de téléchargement habituelles (la vérification d'image Proovd de Discord signale les fichiers de plus de 8 Mo).
Si le titre et la description s'affichent mais pas l'image, l'URL de l'image est généralement bloquée, redirigée de manière étrange ou ne figure pas dans le code HTML initial.
4. Cache obsolète Discord
Discord met en cache les intégrations par URL. Il n'y a pas de «Sharing Debugger» public pour Discord. Après avoir modifié les balises :
- Publiez une URL légèrement différente, telle que
?v=2, donc Discord la traite comme nouvelle. - Ou supprimez l'ancien message et republiez-le une fois que le site diffuse réellement le nouveau HTML (confirmez avec view-source ou curl, pas seulement votre navigateur).
5. Les robots et les webhooks sont un problème différent
Un robot publiant une URL a toujours besoin de EMBED_LINKS dans ce canal si vous vous attendez à ce que Discord intègre automatiquement l'URL. Les intégrations riches intégrées à l'API sont des charges utiles JSON, et non Open Graph. Si une URL collée par l'homme fonctionne et que l'URL du bot ne fonctionne pas, inspectez les indicateurs de message du bot (y compris les suppressions intégrées) plutôt que vos balises og:.
Discord vérificateur de liens vs Discord vérificateur de serveur
Les requêtes de recherche telles que « Discord vérificateur de liens », « Discord vérificateur d'intégration » et « Discord vérificateur de liens de serveur » ne sont pas le même travail :
- Link / embed checker — inspectez Open Graph sur une URL publique. C'est à cela que sert la page d'aperçu Discord de Proovd.
- Serveur / vérificateur d'invitation — les images de démarrage d'invitation et les widgets de serveur sont une fonctionnalité Discord différente. Cet article ne prétend pas que Proovd les inspecte.
Liste de contrôle rapide
- D'autres personnes du même canal voient-elles la carte ?
- L'aperçu du site Web est-il activé dans vos paramètres utilisateur Discord ?
- La chaîne accorde-t-elle Embed Links à l'affiche ?
- L'URL est-elle entourée de
< >? - Y a-t-il
og:title/og:imagedans la première réponse HTML (pas seulement après JavaScript) ? - Un client non-navigateur peut-il récupérer l'URL sans contestation 403 ?
- Avez-vous republié avec une nouvelle chaîne de requête après avoir modifié les balises ?
Questions fréquemment posées
Pourquoi mon lien n'affiche-t-il pas d'aperçu sur Discord ?
Divisez le problème. Si cela échoue uniquement pour vous, corrigez l’autorisation d’intégration du client ou du canal. Si cela échoue pour tout le monde, Discordbot n'obtient pas de données Open Graph utilisables : balises manquantes, balises JS uniquement, image HTTP ou récupération bloquée.
Comment faire un aperçu du lien sur Discord ?
Mettez Open Graph balises dans le HTML rendu par le serveur, utilisez les URL d'image HTTPS Discord peuvent être récupérées, gardez Embed Links autorisées pour l'affiche et collez l'URL nue (non enveloppée dans < >).
Comment puis-je vérifier une intégration Discord sans la publier sur un serveur ?
Utilisez un vérificateur d'aperçu de lien Discord tel que Proovd. Cela n'effacera pas le cache de Discord ; il montre si les balises sont présentes pour un robot.
Articles connexes
Vérifiez d'abord le côté du site Web
Collez l'URL dans Proovd et comparez la carte Discord avec Slack, LinkedIn, X, WhatsApp et Reddit. Si les balises apparaissent juste là et que Discord ne montre toujours rien, le travail restant est Discord les paramètres ou Discordbot sont bloqués.