Rules / og-image-bytes-exceeds-platform-budget · ruleset 2026-07
Image exceeds a platform byte budget
| Rule id | og-image-bytes-exceeds-platform-budget |
|---|---|
| Severity | warning |
| Category | Images |
| Platforms | all platforms |
| Needs human | no |
What this is
Image exceeds a platform byte budget. OGKit rule og-image-bytes-exceeds-platform-budget (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:
Image exceeds a platform byte budgetog-image-bytes-exceedsWhatsApp image too largeog:image file size
Why it matters
WhatsApp and some IM clients silently drop oversized images. A beautiful PNG that is 1MB+ may never show.
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
- Check Content-Length or file size of og:image.
- WhatsApp and some IM clients silently drop oversized images (~300KB class budgets).
How to fix
Compress to JPEG/WebP under the strictest relevant budget (WhatsApp is often the tightest). Prefer ~100–300KB for chat apps.
No single template snippet applies; use the measured and expected values in an OGKit finding.