X (Twitter) card not showing or not updating

X builds the card from twitter: tags, falling back to og: tags. There is no longer a validator that refreshes the cache, so the fix is good tags plus a fresh URL.

Last updated

Check your URL

Refresh preview

Validate X card

Quick fix

  1. Check the page with the Twitter card validator.

  2. Set twitter:card to summary_large_image and add twitter:image or og:image.

  3. Use a 2:1 image under 5 MB in JPG, PNG, WebP or GIF.

  4. Share the URL with ?v=2 so X fetches it as a new link.

Why the X card is missing or old

  • There’s no twitter:card tag, or it’s set to a type you didn’t want.

  • robots.txt or a firewall blocks Twitterbot. X’s troubleshooting guide lists both as common causes.

  • The image breaks a rule. SVG isn’t supported and files must be under 5 MB.

  • X cached the old card. Its guide says the crawler re-indexes card tags roughly every seven days.

  • The image URL didn’t change. Caches key on the image address, so a new image needs a new URL.

How to fix it

  1. Run the URL through the Twitter card validator to see the card X will build.

  2. Add <meta name="twitter:card" content="summary_large_image">.

  3. Point twitter:image or og:image at a unique image for the page, not your logo.

  4. Allow Twitterbot in robots.txt and in your CDN or firewall rules.

  5. Share the link with a query string such as ?v=2 to get a fresh fetch.

Tags X reads

  • twitter:card: summary_large_image or summary

  • twitter:title, falling back to og:title

  • twitter:description, falling back to og:description

  • twitter:image, falling back to og:image

  • twitter:image:alt, up to 420 characters

  • twitter:site for the @username

Image size rules

  • Aspect ratio 2:1 for summary_large_image

  • Minimum 300 x 157 px, maximum 4096 x 4096 px

  • Under 5 MB

  • JPG, PNG, WebP or GIF (first frame only); no SVG

How to force a refresh

X has no refresh tool. The Card Validator lost its preview in 2022. Share the URL with a new query string, or change the image URL when you replace the image. Posts already published keep their card. The refresh tool has the steps for every app.

Not verified: X removed its card documentation from developer.x.com. The rules on this page come from the archived 2024 version of X’s docs and may have changed.

Sources

FAQ sur le générateur de balises meta

What image size works for a Twitter summary_large_image card?

A 2:1 image between 300 x 157 px and 4096 x 4096 px, under 5 MB, in JPG, PNG, WebP or GIF.

How do I refresh a Twitter card?

There’s no official refresh button any more. Share the URL with a new query string so X fetches it again.

Does X use Open Graph tags?

Yes, as a fallback. If twitter:title, twitter:description or twitter:image are missing, X uses the og: version.

Check your page, then refresh the preview

Paste your URL into the free checker to see the exact tags each app reads. Once the tags are right, use the refresh tool to clear the old preview.

Check your URL

Refresh preview

Validate X card

Related guides

LinkedIn link preview not working or not updating

LinkedIn builds the card from four og: tags and keeps a cached copy. Fix the tags, then make LinkedIn fetch the page again with Post Inspector.

Discord embed not showing or not updating

Discord fetches the page once, reads the tags in the server HTML and caches the embed for about 30 minutes. It never runs your JavaScript.

Next.js Open Graph image not working

Most Next.js preview bugs come from the Metadata API: a missing metadataBase, an openGraph object that replaces the parent one, or an image file over the limit.