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-bytes-exceeds-platform-budget · ruleset 2026-07

Image exceeds a platform byte budget

warningog-image-bytes-exceeds-platform-budget

Name

Image exceeds a platform byte budget og-image-bytes-exceeds-platform-budget

WhatsApp and some IM clients silently drop oversized images. A beautiful PNG that is 1MB+ may never show.

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.

Copy or download

Copyable Markdown for a teammate or an agent chat.

# og-image-bytes-exceeds-platform-budget — Image exceeds a platform byte budget

- **Name:** Image exceeds a platform byte budget

## Description

WhatsApp and some IM clients silently drop oversized images. A beautiful PNG that is 1MB+ may never show.

## How to fix

Compress to JPEG/WebP under the strictest relevant budget (WhatsApp is often the tightest). Prefer ~100–300KB for chat apps.

## Rule docs

https://ogkit.akr.moe/rules/og-image-bytes-exceeds-platform-budget

Download an Agent Skill package for this rule.

Download og-image-bytes-exceeds-platform-budget.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-bytes-exceeds-platform-budget
Severitywarning
CategoryImages
Platformsall platforms
Needs humanno

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:

  • could not be downloaded because it exceeded the maximum allowed sized of 8Mb
  • no bigger than 8mb
  • The size of the image file must not exceed 8 MB.
  • Images must be less than 5MB in size
  • Max file size: 5 MB
  • This image should be under 600KB in size
  • images that are too large (>5 MB) will fail to load
  • Image exceeds a platform byte budget
  • og-image-bytes-exceeds
  • WhatsApp image too large
  • og: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

  1. Check Content-Length or file size of og:image.
  2. WhatsApp and some IM clients silently drop oversized images (~300KB class budgets).
OGKit