← Documentation

Troubleshooting OG Tags

How to diagnose and fix missing or broken Open Graph tags on your site.

Troubleshooting OG Tags

Your link preview looks wrong — no image, wrong title, or a generic description. Here’s how to find and fix the problem.

Check what platforms actually see

Paste your URL into the Inspect tool. It shows exactly what meta tags are on your page and flags anything missing.

The most common issues:

Missing og:image

Without og:image, every platform shows a blank or auto-generated thumbnail. Add this to your <head>:

<meta property="og:image" content="https://yoursite.com/og-image.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">

The image must be an absolute URL starting with https://. Relative paths don’t work.

Missing og:title or og:description

Platforms fall back to <title> and <meta name="description"> when OG tags are missing. If those are also missing, you get a URL and nothing else.

<meta property="og:title" content="Your Page Title">
<meta property="og:description" content="A short description of your page.">

Keep og:title under 60 characters and og:description between 55-200 characters.

Wrong twitter:card type

If your image shows as a tiny square on X/Twitter instead of a large banner, you need:

<meta name="twitter:card" content="summary_large_image">

Without this, X defaults to summary which shows a small square thumbnail.

Tags are there but preview is stale

Platforms cache previews aggressively. After fixing your tags:

  • Facebook: Use the Sharing Debugger to force a re-scrape
  • X/Twitter: Use the Card Validator
  • LinkedIn: Append ?v=1 to your URL when re-sharing, or use the Post Inspector
  • Discord: Edit and re-paste the link — Discord re-fetches on edit

Dynamic pages aren’t showing tags

If your page is a single-page app (React, Vue, etc.) that renders client-side, social platform crawlers won’t see your meta tags. They don’t execute JavaScript.

Solutions:

  • Use server-side rendering (SSR) or static site generation (SSG)
  • Add meta tags in your HTML template before the JS app loads
  • Use a prerendering service

OG image templates for link previews. A rendering platform for dynamic images at any size — email, publishing, and beyond.

Made with ♥️ by Paper Crow