Issue library · 4 social previews checks

Open Graph and social preview issues

Align Open Graph and X/Twitter previews with the canonical page and describe the shared image accurately.

Direct answer

Use accurate Open Graph and X/Twitter fields when social sharing matters. The preview title, description, URL, image, and image alternative should describe the same canonical page.

Why this area matters

Consistent previews improve clarity when links are shared. Social metadata is useful packaging, not a direct ranking guarantee. Accurate image alternatives also preserve the preview’s purpose when the image is unavailable or interpreted through assistive technology. Review each route separately so a generic homepage message does not misrepresent a specific guide, tool, or reference page.

Repair workflow

  1. Choose the canonical page message and preview image.
  2. Set accurate Open Graph fields.
  3. Add a supported card type and fallback fields for X/Twitter.
  4. Describe informative social images.

Verification checklist

  • Inspect rendered meta tags.
  • Compare og:url with the canonical.
  • Use platform preview tools where available.

Exact findings explained

Open Graph fields are incomplete

One or more title, description, or image fields are missing.

What to do

Add truthful values when the page is likely to be shared.

How to verify

Inspect a generated preview and compare it with the visible page.

og:url differs from canonical

The social URL and preferred search URL disagree.

What to do

Use the same preferred public URL unless the difference is deliberate and documented.

How to verify

Compare the rendered canonical and og:url after redirects.

X/Twitter card is incomplete

The card type, title, or image fallback is missing.

What to do

Set a supported card type and reuse accurate Open Graph values where appropriate.

How to verify

Inspect the final card tags and preview.

Social image lacks alternative text

A social image is present without an Open Graph image description.

What to do

Add concise og:image:alt when the preview image conveys information.

How to verify

Read the alternative without viewing the image and confirm it identifies the image’s purpose.