Rules / description-too-long · ruleset 2026-07
Description exceeds platform display budgets
| Rule id | description-too-long |
|---|---|
| Severity | warning |
| Category | Optimization |
| Platforms | all platforms |
| Needs human | no |
What this is
Description exceeds platform display budgets. OGKit rule description-too-long (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:
Description exceeds platform display budgetsog:description too longdescription truncated
Why it matters
Over-long descriptions are clipped mid-sentence. Readers never see your CTA.
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
- Measure og:description length against the strictest platform budget you care about.
How to fix
Aim for ~70–200 characters. Put the hook in the first 100 characters. Platforms also clamp the description to a fixed number of lines, so a description that fits the character budget can still be cut by the box — the per-platform preview card shows where.
No single template snippet applies; use the measured and expected values in an OGKit finding.