Guides

Fix the link card, whatever app it breaks in.

Start with the symptom. Each guide explains what the crawler actually reads, how to check it yourself with curl or view-source, and what to change. All 33 are free to read. To crop an image to 1200×630, use the Open Graph image resizer. To write the tags, use the Open Graph tag generator. To see the cards from words you type, use the link preview mockup.

My card isn't showing at all

Crawler blocked

Right tags, bare URL? Bot protection, a WAF rule, robots.txt, or a login wall may be answering the preview crawler instead of your page.

Read the guide

JavaScript / SPA previews

Preview crawlers read server HTML and don't run your bundle. Tags added by React, Vue, or a head manager after load never arrive.

Read the guide

Absolute OG image URL

Relative og:image paths break most crawlers. Use absolute https and verify before you rescrape.

Read the guide

OG image format

SVG share images show no picture, WebP and AVIF are hit and miss, and a CDN can swap your PNG behind your back.

Read the guide

og:image not showing

Walk the usual causes in order: relative URL, blocked bot, size or format, redirects, then cache. Each step links to the longer guide.

Read the guide

Pages missing og:image

Some pages share with a picture and some don’t? Check every page in your sitemap, find the template that skips og:image, and fix it once.

Read the guide

Discord embed not showing

Discord’s own rules for a missing preview: the fetch, twitter:card, image format, theme-color, and a cache of about 30 minutes.

Read the guide

Microsoft Teams

Teams can build a preview from a title, a description, and og:image. The checker reads those tags on the live page.

Read the guide

My card shows, but it's wrong or out of date

Clear OG cache

The live HTML is right but Slack, X, LinkedIn, Discord, or iMessage still show the old card. Verify tags, then rescrape.

Read the guide

OG image size

Start with 1200×630 and a center safe zone. Crop notes for Facebook, X, LinkedIn, Slack, Discord, and WhatsApp.

Read the guide

OG title & description

Soft length guidance, specific page titles, and how each platform truncates.

Read the guide

og:url vs canonical

When og:url and rel=canonical disagree, scrapers pick the wrong page identity. Align both.

Read the guide

Twitter Card types

summary is a small square thumb; summary_large_image is the big landscape card. twitter:card picks the layout.

Read the guide

How each app unfurls links

Slack vs Discord

Slack is Open Graph–first with a sidebar thumb. Discord uses twitter:card to pick a large embed.

Read the guide

LinkedIn vs X

LinkedIn is Open Graph with a landscape card. X uses twitter:card to pick large vs small.

Read the guide

iMessage link preview

Apple rich links are Open Graph–based. Missing og:image usually collapses to a plain URL.

Read the guide

WhatsApp / Telegram

Chat unfurls lean on Open Graph. An absolute, publicly fetchable og:image matters most.

Read the guide

Facebook / Meta

Meta reads Open Graph for link cards. Rescrape with the Sharing Debugger after you verify tags.

Read the guide

Bluesky

Bluesky reads og:title, og:description, and og:image, then stores the card in the post. A later tag fix does not update old posts.

Read the guide

Mastodon

Every Mastodon server fetches the page itself and caches one card per URL. A firewall can block some servers, and a tag fix does not update old posts.

Read the guide

Reddit

The link post title is what you type. Reddit Help does not publish the thumbnail rules. The last public scraper reads og:image, then a short fallback list.

Read the guide

Threads

Threads cards come from Open Graph tags fetched by Meta. Allow facebookexternalhit, use an absolute og:image, and re-scrape in the Sharing Debugger.

Read the guide

Check the tags a platform reads

Twitter Card validator

X removed the preview from its Card Validator. Check twitter:card, twitter:title, twitter:image, and the Open Graph fallback on the live page.

Open the checker

LinkedIn Post Inspector alternative

See og:title, og:image, og:description, and og:url without signing in to LinkedIn. Post Inspector is still how you refresh LinkedIn’s cache.

Open the checker

Facebook Sharing Debugger alternative

Read the Open Graph tags Facebook scrapes, without logging in. The Sharing Debugger is still how you ask Facebook to look again.

Open the checker

Slack link preview checker

See og:title, og:description, og:image, the Twitter fallback, and an oEmbed link on the live page.

Open the checker

Discord embed checker

See the Open Graph tags, theme-color, and whether twitter:card is summary_large_image.

Open the checker

iMessage link preview checker

See og:title, og:image, apple-touch-icon, and the favicon on the live page.

Open the checker

WhatsApp link preview checker

See og:title, og:description, and og:image on the live page. The image needs to be an absolute https URL.

Open the checker

Telegram link preview checker

Check og:title, og:description, and og:image, the safe Open Graph set for Telegram.

Open the checker

Microsoft Teams link preview checker

See the title, description, and og:image Microsoft documents. A preview needs the image, or both a title and a description.

Open the checker

Bluesky link preview checker

See og:title, og:description, and og:image, the tags Bluesky’s posts guide stores on the post. The guide does not publish a crop.

Open the checker

Threads link preview checker

See og:title, og:description, and og:image. Threads doesn’t publish link-card rules, so the check follows Meta’s Facebook tags and says so.

Open the checker

Mastodon link preview checker

See the title Mastodon reads (JSON-LD, then og:title, then the page title) and og:image. No title, no card.

Open the checker

Seeing the card

Link preview mockup

Free, in your browser. Type a title, a description, a site name, and a URL, then drop an image. See approximate cards for X, Facebook, LinkedIn, Slack, Discord, and iMessage, and where long text gets cut. Nothing is uploaded.

Open the mockup

Making the image

Open Graph image resizer

Free, in your browser. Crop to 1200×630, keep words in the safe area, and download a PNG or JPEG. The image is not uploaded.

Open the resizer

Your site is on WordPress, Shopify, Squarespace, Webflow, Wix, Ghost, or Framer

WordPress share image

Yoast and Rank Math: the social image, the featured-image fallback, and a caching plugin that keeps serving the old tags.

Read the guide

Shopify

The social sharing image in Online Store preferences, the featured image on a product or collection, and theme files that override both.

Read the guide

Squarespace

The social sharing logo, a per-page alternate image, and the header logo, which only fills in on the homepage.

Read the guide

Webflow

Open Graph image in page settings, an Image field on a CMS collection template, and a publish before the live page changes.

Read the guide

Wix

Social share image, title, and description in SEO settings, for a page type or one page, blog post, or product.

Read the guide

Ghost

The Facebook card and X card on a post, the site cards under General, and the tags {{ghost_head}} prints.

Read the guide

Jekyll / GitHub Pages

Why jekyll-seo-tag prints no og:image, the front matter default that fixes every page, and the url setting.

Read the guide

Hugo

The opengraph.html partial call, where Hugo finds og:image, the params.images default, and the baseURL localhost trap.

Read the guide

Eleventy (11ty)

The base-layout tags, a site-wide default image in _data, the htmlBaseUrl filter for absolute URLs, and the passthrough copy.

Read the guide

Framer

Page Images → Social Preview on that page, a CMS image field for each item, then publish.

Read the guide

Adding the tags

OG tags by framework

Copy-paste share tags for Next.js, Astro, Hugo, and WordPress, plus the traps that wipe your image.

Read the guide

Open Graph tag generator

Free, in your browser. Enter the page URL, title, description, and image, then copy the meta tags. Checking the live page is the next step.

Open the generator