Last updated:
Twitter Card Validator
This Twitter card validator checks a page's X card tags, the Open Graph tags they fall back to, and the image X would use.
How to use the Twitter card validator
Twitter is now called X, so this is an X card validator too, but the tags kept their old names: each still starts with twitter:. For a live page, choose "Check a URL". Our server fetches the page as SchemaBizBot and returns the HTML to your browser, where the checks run; the result shows the fetch's status, redirects, size and time, with a "Copy a link to this check" button. A link such as /seo/twitter-card-validator/?url=https://example.com/ runs the check when it's opened.
For markup that isn't published yet, choose "Paste HTML". That check stays in your browser and fetches nothing, so it can't measure the image. "Try an example page" loads a sample guide with problems built in: it has no twitter:card, so the X card tab notes that X may show a summary card from its Open Graph tags, and its relative og:image is an error on the Open Graph tab.
What the X card tab shows
The page opens on the X card tab. Each tab's badge counts its errors and warnings, and findings are labeled Error, Warning, Note or OK. Here you get:
- whether
twitter:cardis one of the four types, or, when it's missing, whether X may still show a summary card; - whether
twitter:siteis there; - the title, description and alt text against X's length limits;
- the image's size and format against the card type's limits (URL checks only);
- a table of every value X reads, marked "from og:…" where it comes from an Open Graph fallback;
- a preview in the card's layout, with a placeholder drawn at the image size found. The image itself is never loaded or shown.
The four card types
twitter:card chooses the layout. X's card markup defines four values: summary, summary_large_image, app and player. Anything else is a warning, which catches typos like summary-large-image.
summary
A small square image beside the title and description. X gives it a 1:1 ratio and crops it to a square, so it suits a picture that still reads at thumbnail size, such as a product shot.
summary_large_image
A wide 2:1 image above the title, for pages where the picture is a reason to click. The checker warns when this type is set and the page has neither twitter:image nor og:image.
app and player
The other two types in X's markup. The validator accepts either as a valid value; this page doesn't cover what else they need.
X card tags and their Open Graph fallbacks
X uses an Open Graph tag only when the matching twitter: tag is missing. twitter:site has no Open Graph equivalent:
| X tag | Falls back to | Limit |
|---|---|---|
twitter:card | og:type, with og:title and og:description: a summary card may be shown | one of the four types |
twitter:site | none | the site's @username |
twitter:title | og:title | 70 characters |
twitter:description | og:description | 200 characters |
twitter:image | og:image | under 5 MB, at most 4096 × 4096 |
twitter:image:alt | og:image:alt | 420 characters |
A title or description over its limit is a note; alt text over 420 characters is a warning. These are card limits. Search results cut by width instead, which the title tag checker measures.
Card image sizes
- summary: 1:1, at least 144 × 144 pixels, at most 4096 × 4096, cropped to a square.
- summary_large_image: 2:1, at least 300 × 157 pixels, at most 4096 × 4096.
- Both: less than 5 MB; JPG, PNG, WEBP or GIF. SVG isn't supported, and only the first frame of an animated GIF is used.
X's docs also advise against a generic image such as the site's logo or the author's photo.
How the checker reads the real size
Declared dimensions can be wrong, so for a URL check our server reads only the first 64 KB of the image, enough for its format, width and height. The image is never passed on or kept. The X card tab then warns about an image under 144 × 144 on a summary card or 300 × 157 on a large one, over 4096 on either side, in another format, or of 5 MB or more. Pasted HTML has no image to read.
twitter:site
X's documentation says either twitter:site or twitter:site:id is required. twitter:site holds the website's @username, such as @example. The checker reports a missing one as a note.
Two card blocks
The shortest complete card leans on Open Graph; only the card type and the account are X tags:
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@example">
<meta property="og:type" content="article">
<meta property="og:title" content="How to true a bicycle wheel">
<meta property="og:description" content="Find the wobble and fix it with a spoke key.">
<meta property="og:url" content="https://example.com/guides/true-a-wheel/">
<meta property="og:image" content="https://example.com/img/wheel-1200x630.jpg">
<meta property="og:image:alt" content="A bicycle wheel in a truing stand">
The full version also writes out the four X tags that have fallbacks; the Open Graph tags above stay as they are. It's worth the lines when the text on X should differ, or when the large card gets its own 2:1 image while og:image keeps the 1.91:1 shape Facebook asks for:
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@example">
<meta name="twitter:title" content="Truing a bicycle wheel, step by step">
<meta name="twitter:description" content="A wobbly wheel, a spoke key and twenty minutes.">
<meta name="twitter:image" content="https://example.com/img/wheel-1200x600.jpg">
<meta name="twitter:image:alt" content="A bicycle wheel in a truing stand"> Common card mistakes, and what the checker reports
- A relative image address. An
og:imagesuch as/img/card.jpgis an error on the Open Graph tab, and it's the tag X falls back to. - A large card with no image.
summary_large_imagewithouttwitter:imageorog:imageis a warning. - A misspelled card type. Any value outside the four is a warning.
- An image too small for its card. Under 144 × 144 or 300 × 157 is a warning; the Open Graph tab calls out a 1 × 1 placeholder pixel as an error.
- An SVG logo as the image. A format warning, and the generic image X's docs advise against.
Related checks
A card is only as good as the Open Graph tags under it: the Open Graph checker opens the same tool on the tags X falls back to, with Facebook's image sizes. The meta tag checker starts on the Overview, every area of the head at once, and the SERP simulator shows the page as a search result.
Frequently asked questions
FAQ
Do I need twitter: tags if my page already has Open Graph tags?
Only two of them. X reads og:title, og:description, og:image and og:image:alt when the matching twitter: tag is missing. twitter:site has no fallback. Without twitter:card, X's documentation says a summary card may be rendered when og:type, og:title and og:description exist, so a page that wants the large image has to ask for it.
Which card type should I use?
Decide by the image you have. summary shows it as a small square beside the text; summary_large_image shows a wide 2:1 image above it, and needs one: the checker warns when it's set and the page names no image.
Why is my card image cropped?
Usually because the page uses a summary card, whose image X's documentation says is cropped to a square, so a wide photo loses both sides. Crop it to 1:1 yourself with the subject in the middle, or switch to summary_large_image with an image close to 2:1.
Does the Twitter card checker store my HTML or the page it checks?
Nothing you paste leaves your browser. For a URL check, the address is sent to our server, which fetches the page (and, for that page, its canonical target when that's another page, the first bytes of its social images and, if you check return links, up to 10 alternates) as SchemaBizBot. Like every tool on the site, the checker records what kind of check ran: the tab, how many required Open Graph tags are missing, the twitter:card type, what the canonical points at, whether the image passed, hreflang counts and the codes of the problems found; never a tag's text or the page's content. A URL check also records the checked page's address without its query string (see the privacy policy).