How to Fix a Broken Facebook Link Preview — share-preview.com

Facebook link previews not showing? Learn why they break, how to use the Sharing Debugger to fix them, clear the cache, and prevent future issues.

Troubleshooting Updated February 2026 · 10 min read

How to Fix a Broken Facebook Link Preview

You share a link on Facebook. Instead of a beautiful rich preview with your image and headline, you get a grey box with nothing. Or worse — the wrong image, broken text, or missing description. Facebook link preview failures are frustrating and cost you clicks. This guide explains exactly why Facebook previews break, walks you through the Facebook Sharing Debugger step-by-step, shows you how to clear the cache, and provides strategies to prevent broken previews from happening again.

Table of Contents
  1. Why Facebook link previews break
  2. Common causes of broken previews
  3. Using the Facebook Sharing Debugger
  4. Step-by-step troubleshooting guide
  5. Understanding and clearing the cache
  6. Image-specific issues and fixes
  7. Validating your Open Graph tags
  8. Prevention strategies for the future

1. Why Facebook link previews break

When you paste a link into Facebook, here's what happens behind the scenes:

  1. Facebook sends a bot to crawl your page
  2. The bot looks for Open Graph (OG) meta tags in your page's <head>
  3. If found, Facebook extracts the title, description, image URL, and other metadata
  4. Facebook validates that the image URL returns a 200 status code and the image is accessible
  5. Facebook stores this data and generates a preview card

If any step fails, you get a broken preview. The most common failure points:

  • Missing OG tags — Page has no Open Graph tags at all
  • Image URL broken — OG image URL returns 404 or is unreachable
  • Wrong image dimensions — Image is too small (below 600 × 315px)
  • Server errors — Your image server returns 403, 500, or connection timeout
  • Cached old version — Facebook cached a broken version and won't re-crawl

2. Common causes of broken previews

Cause 1: Missing or incomplete OG tags

<!-- ❌ Broken — missing og:description -->
<meta property="og:title" content="My Page">
<meta property="og:image" content="/image.png">

<!-- ✅ Fixed — all 4 required tags -->
<meta property="og:title" content="My Page">
<meta property="og:description" content="Description here">
<meta property="og:image" content="https://yourdomain.com/image.png">
<meta property="og:url" content="https://yourdomain.com/page">

Cause 2: Image URL is relative instead of absolute

<!-- ❌ Broken — relative URL doesn't work with Facebook's bot -->
<meta property="og:image" content="/images/my-og-image.png">

<!-- ✅ Fixed — absolute HTTPS URL -->
<meta property="og:image" content="https://yourdomain.com/images/my-og-image.png">

Cause 3: Image dimensions too small

Facebook requires minimum 600 × 315px. LinkedIn requires exactly 1200 × 627px. If your image is smaller, Facebook won't display it.

Cause 4: Image server returns non-200 status

Facebook validates image URLs with a HEAD request. If your server returns 403 Forbidden, 404 Not Found, or times out, the image won't load.

Cause 5: Cached outdated version

Facebook aggressively caches page metadata. Even if you fix your OG tags, Facebook continues serving the old broken preview until you manually clear the cache.

3. Using the Facebook Sharing Debugger

The Facebook Sharing Debugger is your primary tool for diagnosing and fixing broken previews.

Step 1: Access the tool

Go to developers.facebook.com/tools/debug and log in with your Facebook account.

Step 2: Paste your URL

Paste the URL of the page with the broken preview into the input field and click "Debug".

Step 3: Read the diagnostic report

Facebook shows you:

  • All detected Open Graph tags
  • What the preview will look like
  • Any warnings or errors (e.g., missing tags, image too small)
  • The exact image dimensions detected
  • When the page was last crawled

Step 4: Clear the cache

Click the "Scrape Again" button to force Facebook to re-crawl your page and refresh the cached version.

4. Step-by-step troubleshooting guide

Quick checklist before using the Debugger

  • Do you have all 4 essential OG tags? (og:title, og:description, og:image, og:url)
  • Is your og:image URL absolute (starts with https://)?
  • Is your image at least 600 × 315px? (Ideally 1200 × 630px)
  • Does the image file actually exist? (Test the URL in your browser)
  • Is your image server returning a 200 status code? (Check response headers)

If the Debugger shows "No Open Graph tags found"

  1. Check your page's HTML source — look for <meta property="og:title"> tags in the <head>
  2. If tags are missing, add the 4 essential OG tags to your page
  3. Make sure you're using property= (not name=) for OG tags
  4. Deploy your changes to the live server (not just local testing)
  5. Use the Debugger's "Scrape Again" button

If the image is missing from the preview

  1. Check if your og:image URL is absolute (starts with https://yourdomain.com)
  2. Test the image URL directly in your browser — does it load?
  3. Check image dimensions — is it at least 600 × 315px?
  4. Verify your image server doesn't block bots with 403 Forbidden responses
  5. Try a different image to isolate if it's an image-specific issue
  6. Use the Debugger's "Scrape Again" button and check the report

If the preview shows old/wrong information

This is almost always a cache issue:

  1. Fix your OG tags
  2. Deploy to your live server
  3. Open the Facebook Sharing Debugger
  4. Paste your URL
  5. Click "Scrape Again" (critical step)
  6. Wait 30 seconds and refresh the page
  7. Try pasting the link into Facebook again

5. Understanding and clearing the cache

How Facebook's cache works

Facebook caches page metadata for performance reasons. The first time it crawls a page, it stores the OG tag data. On subsequent shares, it uses the cached data. This is fast but means changes don't appear immediately.

Cache lifespan

  • First 24 hours: Cache is frequently refreshed as the link gains shares
  • After 24 hours: Cache becomes sticky — less frequent refreshes
  • After weeks: Cache can persist for months without manual refresh

Forcing a cache clear

Use the Facebook Sharing Debugger's "Scrape Again" button. This is the only way to manually clear the cache. Facebook will:

  1. Send a fresh crawler to your page
  2. Extract new OG tags
  3. Validate the image URL
  4. Update the cached preview

The refresh is usually instant but can take up to 60 seconds. After refreshing, test by pasting the link into a Facebook post.

6. Image-specific issues and fixes

Image type compatibility

Facebook supports PNG, JPG, GIF, and WebP. Use PNG or JPG for best compatibility.

Image too small

Facebook minimum: 600 × 315px. LinkedIn strict: 1200 × 627px. Always create images at 1200 × 630px to support all platforms.

Image file size

Facebook allows up to 8MB, but keep your images under 1MB for fast loading. Use compression tools like TinyPNG or ImageOptim.

Image server blocking

Some servers block bots. If your image is hosted on a CDN or external service, check if it allows requests from Facebook's IP ranges. Facebook crawlers identify themselves with the facebookexternalhit user agent.

HTTPS requirement

Image URLs must use HTTPS. HTTP URLs may work but are increasingly unsupported by Facebook.

Testing image accessibility

# Test your image URL from command line
curl -I https://yourdomain.com/images/og.png

# Should return 200 OK
HTTP/2 200
content-type: image/png
content-length: 45000

7. Validating your Open Graph tags

🔍 Validate with share-preview.com

Paste your URL to see how it appears on Facebook, Twitter, LinkedIn, and Slack simultaneously. Get a complete diagnostic report of all OG tags.

Check Your Page Free →

Command-line validation

Use curl to inspect your page's HTML and verify OG tags are present:

curl https://yourdomain.com/page | grep "og:"

# Should output your OG tags
<meta property="og:title" content="...">
<meta property="og:description" content="...">
<meta property="og:image" content="...">
<meta property="og:url" content="...">

8. Prevention strategies for the future

Strategy 1: Use a template for all pages

Create an OG tag template in your site's base template so all pages include the 4 essential tags by default. Don't rely on manual addition.

<!-- Add to your base <head> template -->
<meta property="og:title" content={{ page_title }}>
<meta property="og:description" content={{ page_description }}>
<meta property="og:image" content={{ page_image_url }}>
<meta property="og:url" content={{ page_url }}>

Strategy 2: Generate OG images programmatically

Use tools like Puppeteer, Vercel OG, or a design tool API to generate OG images automatically. This prevents missing images.

Strategy 3: Test before publishing

Always test new pages with the Facebook Sharing Debugger before announcing them.

Strategy 4: Monitor for broken images

Periodically check your live site's image URLs to ensure they don't break due to server migrations, CDN issues, or accidental deletions.

Strategy 5: Document your setup

Keep a checklist of OG tag requirements so team members know what's needed and can avoid common mistakes.

Pro tip: After fixing broken previews, give Facebook 24 hours before re-sharing. Facebook often continues to serve old cached previews for a few hours even after you click "Scrape Again."

Need to check your current OG tags right now? Use share-preview.com to test — paste any URL and see exactly what Facebook, Twitter, LinkedIn, and Slack will display.


Next reading: The Complete Guide to Open Graph Tags in 2026 — comprehensive reference for all OG properties and best practices.

See How Your Page Looks When Shared

Test your OG tags across Twitter, LinkedIn, Facebook, Slack, and WhatsApp instantly.

Test Share Preview Free →