For AI agents: a documentation index is available at /llms.txt. Markdown versions of these pages are available by appending `.md` to the URL or by sending `Accept: text/markdown`.

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

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

warningog-image-declared-size-mismatch

Name

og:image:width/height does not match actual pixels og-image-declared-size-mismatch

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

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.

Copy or download

Copyable Markdown for a teammate or an agent chat.

# og-image-declared-size-mismatch — og:image:width/height does not match actual pixels

- **Name:** og:image:width/height does not match actual pixels

## Description

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

## 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.

## Rule docs

https://ogkit.akr.moe/rules/og-image-declared-size-mismatch

Download an Agent Skill package for this rule.

Download og-image-declared-size-mismatch.skill

The file is a ZIP of skill-name/SKILL.md (Agent Skills spec). The .skill extension is that ZIP; rename to .zip if a client asks for one.

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.
OGKit