Twitter Card Validator: Complete Guide to Testing Twitter Cards (2026) — share-preview.com

Learn how to use the Twitter Card Validator to test and fix your Twitter Cards. All 4 card types explained, common errors fixed, and full meta tag reference.

2026-02-19

What Are Twitter Cards?

When you share a link on Twitter (now rebranded as X), it doesn't have to appear as a plain URL. Twitter Cards are a set of HTML meta tags that tell Twitter's crawler how to display rich, visual previews of your content — with images, titles, descriptions, and even interactive media.

Think of them as a supercharged version of Open Graph tags, specifically designed for Twitter's platform. While OG tags work across Facebook, LinkedIn, Slack, and dozens of other platforms, Twitter Cards give you precise control over the Twitter/X experience.

The business case for implementing Twitter Cards is strong: tweets with images receive 150% more retweets than text-only tweets, and rich cards drive significantly higher click-through rates. For marketers and developers, Twitter Cards are not optional — they're a baseline for professional link sharing.

Note on Twitter → X rebranding: While the platform is now called "X," the meta tag name attributes still use twitter: as the prefix. The Twitter Card Validator tool lives at cards-dev.twitter.com/validator. All existing twitter: tags continue to function without any changes.

The 4 Types of Twitter Cards

Twitter supports four distinct card formats. Choosing the right one depends on your content type and what experience you want to create for your audience.

Type 1

Summary Card

The default card type. Displays a small thumbnail image (120×120 minimum) on the left, with title and description on the right. Best for blog posts, articles, and general pages.

Type 2

Summary Large Image

The most popular card type. Features a large, prominent image (at least 300×157px, ideally 1200×600px) above the title and description. Best for visual content, news, and marketing pages.

Type 3

App Card

Designed specifically for mobile app promotion. Shows app name, description, icon, and a direct download link to the App Store or Google Play. Requires App Store/Play Store IDs.

Type 4

Player Card

An embedded media player directly in the tweet. Supports video and audio playback without leaving Twitter. Requires Twitter approval and an HTTPS-hosted player iframe.

Summary Card — Visual Preview

🖼 120×120

yoursite.com

Your Page Title Goes Here

A brief description of your content appears here — up to around 200 characters.

The required meta tag for a summary card:

<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="Your Page Title">
<meta name="twitter:description" content="Brief description of your page">
<meta name="twitter:image" content="https://yoursite.com/image.jpg">

Summary Large Image — Visual Preview

🖼 Large Image — 1200×600 recommended

yoursite.com

Your Page Title Goes Here

A brief description of your content appears here.

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Your Page Title">
<meta name="twitter:description" content="Brief description of your page">
<meta name="twitter:image" content="https://yoursite.com/image-1200x600.jpg">
<meta name="twitter:image:alt" content="Descriptive alt text for the image">

App Card

<meta name="twitter:card" content="app">
<meta name="twitter:title" content="Your App Name">
<meta name="twitter:description" content="What your app does in one sentence">
<meta name="twitter:app:id:iphone" content="YOUR_IOS_APP_ID">
<meta name="twitter:app:id:googleplay" content="com.your.app.package">
<meta name="twitter:app:country" content="US">

Player Card

<meta name="twitter:card" content="player">
<meta name="twitter:title" content="Video Title">
<meta name="twitter:description" content="Video description">
<meta name="twitter:player" content="https://yoursite.com/player.html">
<meta name="twitter:player:width" content="1280">
<meta name="twitter:player:height" content="720">
<meta name="twitter:image" content="https://yoursite.com/thumbnail.jpg">

Player Card requires approval: Unlike other card types, the Player card requires manual whitelisting from Twitter. You must apply through Twitter's developer portal and agree to their media policy before the player will render for public tweets.

How to Validate Twitter Cards

Before your Twitter Card goes live, you need to validate it. There are two main methods — Twitter's own legacy validator, and modern multi-platform tools like share-preview.com.

Method 1: Twitter Card Validator (cards-dev.twitter.com/validator)

Twitter provides an official Card Validator at cards-dev.twitter.com/validator. Here's how to use it:

Log in to your Twitter/X developer account

Navigate to cards-dev.twitter.com/validator. You'll need to be logged in to your Twitter account to access the tool.

Enter your page URL

Paste the full URL of the page whose Twitter Card you want to validate. Make sure the page is publicly accessible — the crawler can't reach pages behind login walls or on localhost.

Click "Preview Card"

The validator fetches your page's meta tags and renders a preview of how the card will appear in a tweet. It also shows any warnings or errors in the metadata.

Check the log output

Below the preview, you'll see a log of what the crawler found. Look for "INFO" messages (normal), "WARN" messages (non-critical issues), and "ERROR" messages (card won't display correctly).

Fix issues and re-test

Update your meta tags based on the errors, redeploy, and re-validate. Note: Twitter caches cards for 7 days, but the validator always fetches fresh content.

Method 2: share-preview.com (Recommended)

The Twitter Card Validator only shows how your card looks on Twitter. share-preview.com lets you see previews across Twitter, Facebook, LinkedIn, Slack, and more — all at once. This is especially valuable when you want to make one image work perfectly across platforms before going live.

Common Twitter Card Errors and Fixes

Error: Card not rendering / showing plain URL

The most common issue. Your Twitter Card is not displaying at all, just a plain link.

Fix: Ensure your page has <meta name="twitter:card"> with a valid value (summary, summary_large_image, app, or player). Also verify the page is publicly accessible — private or staging URLs won't work.

Error: Image not appearing on card

The card renders but shows a broken image placeholder or no image at all.

Fix: Your image must be HTTPS, publicly accessible, and under 5MB. JPG and PNG are safe bets. For summary_large_image, the image must be at least 300×157px. Make sure the URL doesn't redirect (Twitter's crawler doesn't follow redirects for images).

Error: "Unable to render Card preview" in validator

The validator can't fetch your page, or returns a crawl error.

Fix: Check that your server doesn't block Twitterbot in robots.txt or via a user-agent check. Add this to your robots.txt: User-agent: Twitterbot / Allow: /

Error: Old/cached image showing after update

You updated your image but Twitter still shows the old one.

Fix: Twitter caches card data for up to 7 days. Use the Card Validator to force-refresh the cache for a specific URL. Alternatively, append a version query string to your image URL (e.g., image.jpg?v=2) to make Twitter treat it as a new resource.

Error: Title or description truncated

Your title or description is cut off in the preview.

Fix: Twitter truncates titles at ~70 characters and descriptions at ~200 characters. Write punchy, front-loaded copy that delivers the key message within these limits.

Error: Card appears as "summary" instead of "summary_large_image"

You specified summary_large_image but Twitter renders the small summary card.

Fix: Your image dimensions are likely too small. The minimum for large image cards is 300×157px, but Twitter recommends 1200×600px for crisp rendering on all screens. Also ensure the image aspect ratio is approximately 2:1.

Twitter Card Meta Tag Reference

Here's a complete reference of all Twitter Card meta tags, organized by card type.

Universal Tags (All Card Types)

Tag	Required	Description	Max Length
`twitter:card`	Required	Card type: `summary`, `summary_large_image`, `app`, `player`	—
`twitter:site`	Optional	Twitter @username of the website (e.g., `@yoursite`)	—
`twitter:creator`	Optional	Twitter @username of the content author	—
`twitter:title`	Required	Title of the content. Falls back to `og:title` if omitted.	70 chars
`twitter:description`	Optional	Short description. Falls back to `og:description`.	200 chars
`twitter:image`	Optional*	HTTPS URL of image. Required for image-based cards. Max 5MB.	—
`twitter:image:alt`	Optional	Alt text for the image. Improves accessibility and SEO.	420 chars

App Card Tags

Tag	Required	Description
`twitter:app:id:iphone`	Required	iOS App Store numerical ID
`twitter:app:id:ipad`	Optional	iPad-specific App Store ID (if different)
`twitter:app:id:googleplay`	Optional	Google Play package name
`twitter:app:url:iphone`	Optional	Custom URL scheme for deep-linking into the iOS app
`twitter:app:url:googleplay`	Optional	Custom URL scheme for deep-linking into the Android app
`twitter:app:country`	Optional	ISO 3166-1 alpha-2 country code if the app is not available globally

Player Card Tags

Tag	Required	Description
`twitter:player`	Required	HTTPS URL to your player iframe
`twitter:player:width`	Required	Player iframe width in pixels
`twitter:player:height`	Required	Player iframe height in pixels
`twitter:player:stream`	Optional	Direct URL to the video/audio stream (mp4, m3u8)

Best Practices for Twitter Cards

Use OG Tags as Your Foundation

Twitter Cards fall back to Open Graph tags for title, description, and image if the Twitter-specific tags are missing. This means you can often add just twitter:card to an existing OG-tagged page and get a functioning card. However, for best results, set both explicitly — Twitter's truncation limits are different from OG specs.

<!-- Open Graph (works on Facebook, LinkedIn, WhatsApp, etc.) -->
<meta property="og:title" content="Your Full Title Here">
<meta property="og:description" content="Your full description, up to 300 characters">
<meta property="og:image" content="https://yoursite.com/og-image.jpg">

<!-- Twitter Cards (overrides OG specifically for Twitter) -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Shorter Title for Twitter">
<meta name="twitter:description" content="Punchier description for Twitter">

Image Specifications Cheat Sheet

summary card: 1:1 ratio, minimum 144×144px, recommended 400×400px, max 5MB
summary_large_image: 2:1 ratio, minimum 300×157px, recommended 1200×600px, max 5MB
player card: Match your video's aspect ratio (16:9 is standard)
Formats: JPG, PNG, WEBP, GIF (animated GIF supported on cards)
Always HTTPS: HTTP images are blocked

Validate Before Every Deploy

Make Twitter Card validation part of your deployment checklist. A broken card on a high-traffic share can mean thousands of missed clicks. The best workflow is to validate in a staging environment before deploying to production — which is exactly where share-preview.com shines, since it doesn't require your page to be publicly live.

Don't Put Text Inside the Image

Twitter crops images differently on mobile vs. desktop, and at different zoom levels. Text that looks perfect on your screen might be cropped on a phone. Design your card images with a safe zone: keep all critical text and logos within the central 80% of the image, leaving generous margins on all sides.

Test All Card Types If You Have Mixed Content

If your site has both blog posts and product pages, you may want different card types for each. Test each template separately — a change to your base layout that fixes one card type can break another.

Test Your Twitter Cards Before Going Live

share-preview.com lets you preview exactly how your links appear on Twitter, Facebook, LinkedIn, Slack, Discord, and more — all in one place. No account required.

Preview Your Cards Free →

Works with any public or staging URL · No sign-up required