Back to guides

Structured Data and Social Metadata: Machine-Readable Context for Your Pages

JSON-LD, Organization schema, Open Graph and Twitter Cards. What breaks silently, and how to verify your social images and canonical URLs agree.

Structured data states facts about a page in a form that does not depend on parsing prose: who publishes it, what it covers, when it was written, what it costs. Search engines use it for rich results, and assistants use it to work out what a page is before deciding whether to cite it. The mechanics matter more than the volume. A JSON-LD block with a syntax error is discarded entirely, and the failure is silent, with no warning and no partial credit. Organization schema is the base layer, because it connects a site to a named entity that other signals can attach to. Open Graph and Twitter Card tags apply the same idea to a different consumer. They control how a link renders when someone shares it, which is a traffic question rather than a ranking one. Their failure modes are specific: an og:url naming a different address than the canonical, an og:locale contradicting the html lang attribute, and, by a wide margin the most common, an og:image URL returning 404 and producing a blank card everywhere the link is posted. These checks parse every structured data block on the page and fetch the social image URLs to confirm they resolve.

Identity schema missing (Organization or Person)

Why it matters

Structured data helps search engines understand what the page is about with less guesswork.

How we check it

Homepage structured data was checked for identity schema (Organization or Person) presence.

How to fix it

Add identity JSON-LD schema to your homepage with @context, @type, name, and url fields — Organization for a company site, Person for a personal site or portfolio.

Structured data not parseable

How we check it

Homepage JSON-LD was parsed and validated.

How to fix it

Fix JSON-LD syntax errors in your structured data. Validate at validator.schema.org. Why this matters: Even a single syntax error can cause search engines to ignore your entire structured data block, forfeiting rich results like star ratings, product prices, and event details.

Social metadata missing

Why it matters

Without Open Graph and Twitter Card tags, social platforms guess the title, description, and image for every link someone shares.

How we check it

Homepage was checked for Open Graph and Twitter Card meta tags.

How to fix it

Add Open Graph and Twitter Card meta tags for rich social sharing previews. Why this matters: When your content is shared on social platforms, these tags control the title, image, and description that appear—poor or missing tags kill engagement.

Open Graph locale mismatch

Why it matters

When og:locale and the html lang attribute disagree, search engines and social platforms get two different answers about which language the page is written in.

How we check it

Open Graph locale was compared against HTML lang attribute.

How to fix it

Set og:locale to match the html lang attribute (e.g., 'en_US' for lang='en'). Why this matters: Mismatched language signals confuse search engines and social platforms about which audience the content targets, reducing relevance scoring.

Open Graph URL mismatch

Why it matters

When og:url and the canonical URL disagree, shares and search results can build up against two different addresses for the same page.

How we check it

Open Graph URL was compared against the canonical tag.

How to fix it

Set og:url to match the page's canonical URL. Why this matters: When Open Graph and canonical signals disagree, social platforms and search engines may index the wrong URL, splitting engagement metrics across duplicates.

Open Graph image unreachable

Why it matters

A broken og:image leaves the shared link with an empty preview, losing the visual that earns most of its clicks.

How we check it

Open Graph and Twitter Card image URLs were fetched to verify reachability.

How to fix it

Fix or replace broken Open Graph and Twitter Card image URLs so they return HTTP 200. Why this matters: Broken og:image URLs produce broken social previews, and search engines may treat missing meta resources as a signal of poor site maintenance.

See How Your Site Ranks

Get a free AI-powered SEO report with actionable findings and priority fixes for your website.

No signup required.