Discord embed not updating
Discord caches link embeds per message, not per URL. Once a message is sent and the embed is fetched, it's frozen. Updating your og:image or og:title won't affect that message. To force a fresh embed, delete the original message and paste the link again. Discord has no built-in re-scrape tool.
Preview your Discord embed in peek →Common causes and fixes
Error
Embed is cached to the original message
Discord embeds are cached per message, not per URL. Delete the original message and paste the link again to get a fresh embed with your updated metadata.
Error
og:image URL is not publicly accessible
Discord's crawler cannot fetch images behind auth, VPNs, or private networks. The image URL must be reachable by anyone on the internet.
Error
og:image uses HTTP instead of HTTPS
Discord requires HTTPS for embed images. Update your og:image content attribute to start with https://.
Error
Tags are injected by JavaScript
Discord does not execute JavaScript when fetching embed data. All og: tags must be in the server-rendered HTML source.
Error
og:title is missing
Discord requires og:title for the embed headline. Without it, Discord will not render a rich embed.
Warning
Image format is not supported
Use JPEG or PNG for og:image. Animated GIFs may display but behavior varies. Avoid SVG (Discord won't render it).
How to force a Discord embed refresh
- 1 Update and deploy your metadata
Fix og:title, og:description, og:image, or og:site_name in your HTML and deploy. Verify the new values are in the page source.
- 2 Delete the original Discord message
The existing message has a frozen embed. Delete it (there's no way to refresh an existing Discord embed).
- 3 Paste the link in a new message
Type or paste the URL in a new message and send. Discord will fetch the current metadata and show the updated embed.
What Discord reads from your page
| Tag | Where it appears |
|---|---|
| og:title | Embed headline |
| og:description | Embed description text |
| og:image | Embed thumbnail or large image |
| og:site_name | Provider label above the title |
| og:url | Canonical link for the embed |
Correct tags for Discord embeds
<!-- Discord reads these og: tags --> <meta property="og:title" content="Your Page Title" /> <meta property="og:description" content="A clear description." /> <meta property="og:image" content="https://example.com/og.jpg" /> <meta property="og:site_name" content="Your Site Name" /> <meta property="og:url" content="https://example.com/your-page" />
Related guides
Frequently asked questions
- Why is my Discord embed not updating after I changed the metadata?
- Discord caches link embeds per message, not per URL. Once a message is sent and Discord fetches the embed, it is frozen. To force a fresh embed, delete the original message and paste the link again. Discord will re-fetch the current metadata for the new message.
- How do I refresh a Discord link embed?
- Delete the original message containing the link and paste the URL again in a new message. Discord will fetch the latest metadata for the new message. There is no built-in re-scrape tool for Discord like LinkedIn's Post Inspector.
- Why is my Discord embed image not showing?
- Discord reads og:image for the embed thumbnail. If the image URL is not publicly accessible, uses HTTP instead of HTTPS, or is in a format Discord does not support, no image will appear. Make sure the og:image is served over HTTPS and is a JPEG or PNG.
- Does Discord execute JavaScript when fetching embeds?
- No. Discord's embed crawler does not execute JavaScript. All og: tags must be present in the server-rendered HTML. Tags injected by client-side scripts will not be seen by Discord.
- What Open Graph tags does Discord read?
- Discord reads og:title, og:description, og:image, and og:site_name. The og:site_name value appears as the provider label above the embed title. Discord does not read twitter:card tags.