Twitter Card Not Showing: Diagnose and Fix the Link Preview

Twitter Card Not Showing: Diagnose and Fix the Link Preview

Find out why a Twitter/X Card is missing by checking raw HTML, crawler access, redirects, card metadata, and the preview image.

约 6 分钟阅读

Start with the HTTP response X can actually read

A browser preview can look correct while X still receives an error page, a redirect loop, or HTML that contains no social metadata. Validate the public production URL with a crawler-style request first. Confirm that the final response is HTML, returns HTTP 200, and does not require a cookie, login, JavaScript challenge, or geographic allow-list.

Run the X Card Validator
  1. 1Paste the exact public URL into the X Card Validator and record the final URL, HTTP status, and redirect chain.
  2. 2Open the raw head HTML section and confirm that the tags are present in the server response rather than added after hydration.
  3. 3Review robots.txt and meta robots results for a rule that blocks Twitterbot or prevents the page from being crawled.

Add the minimum explicit card metadata

Provide a Twitter Card type and complete Twitter plus Open Graph metadata. Keeping both sets aligned gives X an explicit card configuration and gives other social surfaces a stable fallback.

<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Your page title" />
<meta name="twitter:description" content="A concise description of the page" />
<meta name="twitter:image" content="https://your-domain.com/social-card.jpg" />
<meta property="og:title" content="Your page title" />
<meta property="og:description" content="A concise description of the page" />
<meta property="og:image" content="https://your-domain.com/social-card.jpg" />
<meta property="og:url" content="https://your-domain.com/page" />

If the card still does not appear

Compare the detected value and source for every Twitter and Open Graph tag. A fallback can produce a usable preview, but it also shows where the X-specific tag is still absent. Fix every invalid diagnostic, use an absolute HTTPS image URL, then re-run the validation against the deployed page. If the raw HTML and image diagnostics are clean but X shows an older card, follow the cache troubleshooting guide instead of changing healthy metadata repeatedly.

常见问题

Twitter Card Not Showing: Diagnose and Fix the Link Preview 主要解决什么问题？+
Find out why a Twitter/X Card is missing by checking raw HTML, crawler access, redirects, card metadata, and the preview image.
如何开始使用 Twitter Card Not Showing: Diagnose and Fix the Link Preview？+
Paste the exact public URL into the X Card Validator and record the final URL, HTTP status, and redirect chain. Open the raw head HTML section and confirm that the tags are present in the server response rather than added after hydration. Review robots.txt and meta robots results for a rule that blocks Twitterbot or prevents the page from being crawled.