Twitter Card Not Displaying? Here's How to Fix It

Why Your Twitter Card Isn't Showing

You've carefully crafted a tweet with a link, hit publish, and… nothing. No card. No image. Just a bare URL staring back at you. Sound familiar?

Twitter/X cards are how your links look when shared on the platform. When they work, they show a rich preview with your image, title, and description—dramatically increasing engagement. When they don't, your tweet looks like spam.

Let's fix that.

Step 1: Check If You Have the Required Meta Tags

Twitter/X needs specific meta tags to render cards. At minimum, you need:

<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Your Page Title" />
<meta name="twitter:description" content="Your description here" />
<meta name="twitter:image" content="https://yoursite.com/image.jpg" />

The twitter:card tag is required. Without it, Twitter defaults to the most basic card type. The most common values are:

• summary — Small square image with title and description
• summary_large_image — Large rectangular image above title and description (recommended for most sites)

Twitter Falls Back to OG Tags

If you don't have Twitter-specific tags, Twitter will use your Open Graph tags instead:

But twitter:card has NO fallback. You must include it explicitly.

Step 2: Verify Your Image Specs

Twitter is relatively lenient with images compared to WhatsApp, but there are still requirements:

Summary Card (summary)

• Min: 144×144 px
• Max: 4096×4096 px
• Aspect ratio: 1:1 (square)
• Max file size: 5 MB

Summary Large Image (summary_large_image)

• Min: 300×157 px
• Max: 4096×4096 px
• Aspect ratio: 2:1
• Max file size: 5 MB
• Formats: JPG, PNG, WebP, GIF

Step 3: Add twitter:site for Attribution

While optional, the twitter:site tag links your card to your Twitter/X account:

<meta name="twitter:site" content="@yourusername" />
<meta name="twitter:creator" content="@authorname" />

This adds credibility and drives followers. Without it, the card works but shows no attribution.

Step 4: Debug with Twitter's Card Validator

Twitter's Card Validator (cards-dev.twitter.com/validator) lets you preview your card and force a cache refresh. Enter your URL and click "Preview card."

Common validator errors:

• "Card not found" — Missing twitter:card meta tag
• "Image not found" — Image URL is wrong, returns 404, or exceeds 5 MB
• "Unable to render Card preview" — robots.txt is blocking Twitterbot

Step 5: Check robots.txt

Twitter's crawler uses the user-agent Twitterbot. Make sure your robots.txt doesn't block it:

User-agent: Twitterbot
Allow: /

The Complete, Correct Twitter Card Setup

Here's the battle-tested meta tag setup:

<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@yourusername" />
<meta name="twitter:creator" content="@authorname" />
<meta name="twitter:title" content="Your Title (under 70 chars)" />
<meta name="twitter:description" content="Your description" />
<meta name="twitter:image" content="https://yoursite.com/og-1200x630.jpg" />
<meta name="twitter:image:alt" content="Description of the image" />

<!-- Also include OG tags for other platforms -->
<meta property="og:title" content="Your Title" />
<meta property="og:description" content="Your description" />
<meta property="og:image" content="https://yoursite.com/og-1200x630.jpg" />
<meta property="og:url" content="https://yoursite.com/page" />
<meta property="og:type" content="website" />

FAQ

Q: Do I need both OG tags and Twitter Card tags?

A: You need at least twitter:card. For title, description, and image, Twitter falls back to OG tags if Twitter-specific tags are missing. Best practice: include both.

Q: How long does Twitter take to update cached cards?

A: Usually within a few minutes. Use the Card Validator to force a refresh.

Q: Why does my card work on some URLs but not others?

A: Each URL needs its own valid meta tags. If some pages have correct tags and others don't, only the correctly tagged pages will show cards.

Use LinkPeek to test your Twitter card alongside previews for 5 other platforms before publishing.