KNOWLEDGE ARTICLE

What Is Twitter Card?

X link preview

Provides platform-specific metadata for link previews on X/Twitter.

At a glance

Twitter Card fields declare card type, title, description and image. The platform may fall back to Open Graph when specific fields are absent.

Defining a link preview for X

Twitter Card metadata declares a card type, title, description, image and account association. Common summary and summary_large_image cards give images different emphasis. Player and app cards require additional fields and platform-specific conditions.

The platform reads supported twitter:* fields and may fall back to Open Graph or page content. It still controls text truncation, image cropping, caching and safety checks. Metadata supplies inputs, not a pixel-perfect rendering guarantee.

From fetch to displayed card

  • A crawler retrieves a publicly accessible page's HTML head and reads fields such as twitter:card, title, description and image.
  • The image URL must be fetchable and use suitable dimensions and format. Redirects, authentication, hotlink protection or robots restrictions can prevent image retrieval.
  • The platform assembles and caches a card according to its type. Later shares of the same URL may reuse that cached version.
  • Official validation tools may help check fetching after an update, but the platform controls cache timing and whether historical posts refresh.
X retrieving Twitter Card metadata, caching it and displaying a timeline preview
An X card from webpage to timelineShow metadata retrieval, image validation, caching and final rendering

Sharing content across platforms without duplicate editing

A shared content model can supply title, description and image, with X-specific card and account fields added separately. This preserves brand consistency while accommodating different ratios and text lengths. Keep important image content inside a crop-safe area.

Open Graph alone may produce an X preview but offers less card-type control. Twitter Card metadata alone may not serve other platforms. Templates should output both consistently where appropriate.

Practical use and interpretation

Declared type, title, description, image and account can be shown in a simulated X preview. Their presence confirms platform-specific configuration, while the live card can still differ because of caching, platform rules or image access.

If a successfully retrieved page has no twitter:* fields, no dedicated card metadata was found. Incomplete fetching or head data leaves the status unknown.

Points to consider

Dedicated metadata reduces differences caused by platform fallback rules.

Frequently asked questions

Can X show a preview without Twitter Cards?

It may fall back to Open Graph or page information, but the card type and selected fields may not match expectations.

Why does X still show an old image?

Preview caching is common. Verify the new image is publicly accessible and check it with available validation tools. Propagation can take time.

Should I choose summary or summary_large_image?

Summary is more compact; summary_large_image emphasizes a wide image. Choose according to the content and the image's role.

References