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-relative-url · ruleset 2026-07

og:image is a relative path

errorog-image-relative-url

Name

og:image is a relative path og-image-relative-url

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

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" />

Copy or download

Copyable Markdown for a teammate or an agent chat.

# og-image-relative-url — og:image is a relative path

- **Name:** og:image is a relative path

## Description

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

## How to fix

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

### Example fix:

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

## Rule docs

https://ogkit.akr.moe/rules/og-image-relative-url

Download an Agent Skill package for this rule.

Download og-image-relative-url.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-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:

  • All URLs must be absolute
  • I want my og:url or og:image tags to use relative URLs, but the debugger complains about this.
  • 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`
OGKit