Foundations Recommended Updated 2026-05-29

Open Graph protocol

Open Graph tags control how pages look when shared on social platforms and chat apps. Set og:title, og:description, og:image, og:url, and og:type on every page.

What it is

Open Graph (OG) is a set of <meta> tags, originally introduced by Facebook in 2010 and now supported by virtually every social platform, chat app, and link-preview tool. They tell the platform how to display your page when someone pastes the URL.

<meta property="og:title" content="The lang attribute on <html>" />
<meta property="og:description" content="Set a valid BCP 47 language tag on <html> so screen readers, translators, and search engines know what language the page is in." />
<meta property="og:image" content="https://example.com/og/html-lang.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:url" content="https://example.com/foundations/html-lang" />
<meta property="og:type" content="article" />

Note property= (not name=) — Open Graph predates the standard meta name registry and uses the RDFa attribute.

Why it matters

When a link is pasted into Slack, Discord, iMessage, WhatsApp, LinkedIn, Mastodon, Bluesky, or X, the platform fetches the page and reads the OG tags to build a preview card. Without them, the platform falls back to whatever it can scrape — sometimes the <title> and meta description, sometimes the first image it can find, sometimes nothing. The result is unpredictable and often unflattering.

A good preview card gives the link a thumbnail, a headline, and a one-line description. Posts with card previews get measurably more clicks than bare URLs. For any content you want shared, OG tags are the difference between a polished preview and a naked URL.

How to implement

Five tags do most of the work:

og:title — the headline. Usually shorter than the HTML <title> (no site suffix needed; the platform shows the domain separately).
og:description — the snippet under the title. 60–200 characters reads well on most platforms.
og:image — an absolute URL to the preview image.
og:url — the canonical absolute URL of the page. Match your <link rel="canonical">.
og:type — the kind of object: website for the homepage, article for posts, product for shop items.

For the image, the dominant size is 1200 × 630 pixels, a 1.91:1 aspect ratio. It works on Facebook, LinkedIn, Slack, Discord, iMessage, Bluesky, and Mastodon. Constraints to follow:

File size under 5 MB; under 1 MB is safer.
JPEG or PNG. Some platforms accept WebP, many do not.
No critical content within 60 pixels of any edge — platforms crop differently.
Declare og:image:width and og:image:height. Some platforms refuse to use images they cannot pre-size.
Serve over HTTPS. HTTP images are rejected.
Use absolute URLs. Relative og:image paths are not portable.

For X (Twitter), add Twitter Card tags as a fallback. X prefers them when present:

<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="The lang attribute on <html>" />
<meta name="twitter:description" content="Set a valid BCP 47 language tag on <html>..." />
<meta name="twitter:image" content="https://example.com/og/html-lang.png" />

If you skip the Twitter Card tags, X will fall back to your OG tags, which is fine. The one extra value worth adding is twitter:card set to summary_large_image so the preview shows the full-width image instead of a small thumbnail.

Generate the image per page when you can. A unique illustration or screenshot per article is more engaging than a single site-wide card. Many sites generate them on-demand at build time or with an edge function.

Common mistakes

Using name="og:title" instead of property="og:title". The protocol requires property.
Relative URLs in og:image or og:url. Always absolute, always HTTPS.
Image dimensions that drift from 1.91:1 — cropped badly on every platform.
Missing og:image:width and og:image:height. Some platforms skip the image entirely without them.
One generic OG image reused on every page. Works, but missing an opportunity.
og:url that does not match the canonical URL. The two should agree.

Verification

View source and check the five core tags are present and absolute.
Paste the URL into a debugger (Facebook Sharing Debugger, LinkedIn Post Inspector, Slack’s link unfurler, or a direct paste into a chat).
Confirm the image renders at full width, the title is correct, and the description matches.
After updating tags, re-scrape on platforms that cache previews aggressively (Facebook, LinkedIn) so they pick up the new values.