OGKit

Rules / og-image-declared-size-mismatch · ruleset 2026-07

og:image:width/height does not match actual pixels

warningog-image-declared-size-mismatch
Rule idog-image-declared-size-mismatch
Severitywarning
CategoryImages
Platformsall platforms
Needs humanno

What this is

og:image:width/height does not match actual pixels. OGKit rule og-image-declared-size-mismatch (warning). The id is a public API for the docs URL and CI --disable key; do not rename it.

Search phrases that should land on this page:

  • og:image:width/height does not match
  • Declared width
  • declared size mismatch

Why it matters

Wrong declared dimensions mislead crawlers that skip full image downloads and can cause layout glitches.

Which platforms are affected

All OGKit platform profiles, including major social, chat, and search crawlers that consume these tags.

Platform-specific crawler budgets and field priority live in the platform behaviour reference.

How to reproduce

  1. Compare og:image:width / og:image:height to the actual decoded pixel size.

How to fix

Update og:image:width and og:image:height to the real decoded pixel size, or remove them if you cannot keep them accurate.

No single template snippet applies; use the measured and expected values in an OGKit finding.