Check Engine / Checks / Reference

Does your site declare a Twitter card type?

It checks widespread missing card-type declarations on sites with Open Graph titles.

What Check Engine measures

The check builds a missing set from indexable pages without twitter:card. It proceeds only when some indexable page has an Open Graph title and the missing set is greater than a 0.5 share. Pages carrying other Twitter fields are distinguished from pages with no such markup, so the wording can identify a missing card type rather than falsely saying all card tags are absent. For example, a missing-card share of exactly 0.5 does not exceed the finding threshold.

The check reads card metadata and Open Graph titles. It does not ask a social platform to refresh its cache. Review the live page tags before testing an external preview.

How to read the result

The finding is a notice. A nonempty card-type value satisfies this presence condition without establishing that every other preview field is valid or that a particular platform will display the card.

Why it matters

Related metadata can be partly present while a type declaration is missing. Naming the actual gap gives a clearer template fix than replacing the whole preview setup based on an overly broad absence claim.

How to fix it

Review the intended preview style and add an appropriate card-type declaration where missing. Keep its title, description and image consistent with the page. Inspect existing fields before inserting duplicates through another plugin or template. Test the source output and any platform preview separately, recognising that external caches can preserve earlier metadata.

How to fix a broken link preview

What we found in field audits

Problems in Social & sharing were found on 12 of the 14 sites we audited. These are area totals. Read the field-audit method.

Method note

backend/seo_engine/checks/social.py, twitter_card, revision 0bb8e8d3.

Common questions

Does a missing-card share of 0.5 trigger the Twitter card finding?

No. The missing-card share must exceed 0.5. An indexable page with an Open Graph title is also required.

Can a page have Twitter preview fields but still lack a card type?

Yes. The check distinguishes other Twitter fields from a missing card type. That allows a narrower explanation without claiming all preview tags are absent.

Is a missing twitter:card declaration treated as a serious error?

It is only a notice. A card-type value that is nonempty clears the presence comparison. Other preview details still need review.