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-forbidden · ruleset 2026-07
Image URL requires auth or returns 403
Name
Image URL requires auth or returns 403 og-image-forbidden
Crawlers are logged-out anonymous clients. A 401/403 image means a blank card for every share.
How to fix
Host the share image on a public CDN/path with no cookies, signing, or IP allowlists required for GET.
No single template snippet applies; use the measured and expected values in an OGKit finding.
| Rule id | og-image-forbidden |
|---|---|
| Severity | error |
| Category | Images |
| Platforms | all platforms |
| Needs human | no |
What this is
Image URL requires auth or returns 403. OGKit rule og-image-forbidden (error). 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:
Provided og:image could not be downloadedThe crawler accepts deflate and gzip content encodingsInvalid Image. This image cannot be fetched.Image URL requires auth or returns 403og:image 403og:image forbiddencannot fetch og:image
Why it matters
Crawlers are logged-out anonymous clients. A 401/403 image means a blank card for every share.
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
- Request the og:image URL without cookies/auth. A 401/403 means crawlers cannot fetch it.
- CDN signed URLs that expire also fail social scrapes.