Skip to content
GitHub
Sections

Reference · Things to avoid

An indexable page a link preview cannot read

Forbidden
A link pasted into a message or a post that shows a bare address, or the site's name over a line of its navigation
Instead
Every indexable page states its own preview: og:title and og:description, beside its <title> and meta description, and og:type for what it is (article for a post). An image and og:url take the page's full address: add them once the site has one, never as a relative path.

What this rule looks like

Forbidden
Instead

Why this rule

The card is met before the page, often by someone who never opens it. Without these tags each service builds the card from whatever it finds, and they find different things. A preview is copy, like the title and description: the change that rewrites the page rewrites its card (J-120), and a value the page already holds is read, not typed again (J-126).

Kind
Rule
Section
Things to avoid
Group
Search and sharing
Bucket
mechanical
Severity
warning
Detector
metadata
Since
v0.25.0

Read as plain text