OGKit

Rules / og-image-relative-url · ruleset 2026-07

og:image is a relative path

errorog-image-relative-url
Rule idog-image-relative-url
Severityerror
CategoryImages
Platformsall platforms
Needs humanno

What this is

og:image is a relative path. OGKit rule og-image-relative-url (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:

  • og:image is a relative path
  • relative og:image
  • og:image relative URL

Why it matters

Social crawlers resolve relative image URLs inconsistently. Many will drop the image entirely.

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. Read og:image content. If it starts with `/` or lacks a scheme, this fires.
  2. Example bad value: `/images/share.jpg`

How to fix

Use an absolute URL including scheme and host, e.g. https://cdn.example.com/og.jpg

Example fix:

<meta property="og:image" content="https://cdn.example.com/og/share.jpg" />