Why your Facebook link preview isn’t showing (and how to fix it)

A Facebook link preview is the visual card that appears when you share a URL, showing an image, title, and description pulled from your page’s Open Graph tags. When that preview goes missing or displays the wrong content, the cause is almost always one of three things: missing metadata, a broken image URL, or stale data Facebook cached from an older version of your page.

This guide covers how Facebook builds link previews, the most common reasons they fail, and the exact steps to fix each one.

What is a Facebook link preview?

A Facebook link preview is a visual card generated from Open Graph tags embedded in your page’s HTML. Facebook reads those tags to display an image, title, and description whenever your URL is shared.

When someone shares a link, Facebook sends a crawler called facebookexternalhit to your page. It reads the og:image, og:title, og:description, and og:url tags from your HTML head, builds the preview from those values, and caches the result. Without those tags, Facebook pulls whatever content it finds first, which is usually a random image, your site’s default title, or nothing.

The preview isn’t something you configure inside Facebook’s composer. It’s generated entirely from your website’s code, which means fixing a broken preview always starts at your metadata.

Why is your Facebook link preview not showing?

Facebook link previews fail for three main reasons. Your page could be missing Open Graph tags entirely, Facebook could be serving a cached version that no longer matches your current content, or the image your og:image tag points to could be broken or too small to render as a full card.

Getting this right matters more than it might seem. Posts with rich previews consistently earn more clicks than bare URLs, and you’ll see that clearly in your Facebook post analytics. That effect compounds across every link your team or audience shares. If you’re putting real effort into Facebook marketing strategy, a broken preview quietly drains that work every time a link goes out.

Here are the four failure modes worth knowing:

• Missing OG tags: Facebook has nothing to read, so it either shows a blank card or pulls unpredictable content from the page
• Cached data: Facebook stored an old preview and keeps serving it even after you’ve updated your tags
• Broken image URL: The og:image tag exists but points to a file Facebook can’t fetch. The URL could be relative, the image may have moved, or it requires authentication
• URL inconsistency: Sharing the same page with different URL formats (http vs https, www vs no-www, trailing slash vs none) creates separate cached entries for each variant

That last point trips up a lot of teams. Updating OG tags and scraping one URL version does nothing for the others, so always use the same canonical URL format everywhere.

How do you fix a Facebook link preview?

Start with the Facebook Sharing Debugger to see exactly what Facebook is reading from your page right now. From there, the fix depends on what the debugger surfaces.

If you manage Facebook content through a Facebook scheduler, preview issues are easier to catch before publishing because many tools surface metadata errors at the composition stage. The same is true of most Facebook marketing tools that include a composer, since they validate the preview at the point of creation. If you’re using a social media management platform across multiple accounts, that early validation matters even more. For everything else, the Sharing Debugger is where diagnosis starts.

Use the Facebook Sharing Debugger to diagnose the issue

Go to developers.facebook.com/tools/debug, paste your URL, and click Debug. The tool shows you what Facebook is currently reading from your page, including the image it found, the title and description it pulled, when it last scraped the URL, and any warnings flagged.

Pay attention to the “Time Scraped” timestamp. If it’s old, Facebook is serving cached data from that earlier scrape. Click Scrape Again to force Facebook to re-read your current page. You may need to click it two or three times for the cache to clear fully.

In 2026, the mobile version of Facebook frequently hides the “Refresh Share Attachment” option on existing posts. Use the desktop Sharing Debugger as your primary fix tool.

Validate and fix your og:image

Facebook requires an og:image of at least 1200×630 pixels at a 1.91:1 aspect ratio. Images under 600px wide display as small thumbnails rather than full-width preview cards. The image URL must be an absolute path starting with https://. A relative path won’t work.

Two image-specific issues are worth flagging for 2026:

• WebP format: Not all Facebook crawlers handle WebP reliably. If your og:image is a .webp file and the preview isn’t loading, convert it to JPEG or PNG and update the tag
• Authentication-gated images: If the image requires a login or any access restriction to view, Facebook’s crawler can’t fetch it and the preview shows a broken image icon

After fixing either issue, run the Sharing Debugger again and click Scrape Again to confirm Facebook picks up the updated image.

How do you add Open Graph tags to your page?

Open Graph tags go in the HTML head section of your page. Depending on how your site is built, you can add them manually in code, through a WordPress SEO plugin, or directly inside a publishing tool.

Set OG tags using Yoast SEO

For WordPress users, Yoast SEO handles OG tag setup without code changes:

1. Open the post or page in the WordPress editor
2. Scroll to the Yoast SEO meta box and click the Social tab
3. Upload your Facebook image and add your title and description
4. Publish, then run the Sharing Debugger and click Scrape Again to confirm the tags are read

Keep the plugin updated. Outdated Yoast versions sometimes fail to push OG tags correctly, causing the Sharing Debugger to return stale data even after you’ve saved new settings.

Manage link previews inside ContentStudio

If you publish through ContentStudio, go to the Optimize tab inside the composer and scroll to the SEO settings section. Add your title, URL, and description there to keep preview configuration inside the same workflow as your publishing. If you’re also scheduling Facebook posts through the same tool, your OG tag settings travel with each post automatically.

Getting these tags right consistently is also part of your broader Facebook page SEO. Properly formatted shared links earn more clicks and engagement than raw URLs, and engagement is one of the signals Facebook’s systems use to decide how widely content gets distributed.

What does Facebook actually do with your OG tags?

Facebook’s crawler reads og:title, og:description, og:image, and og:url from your page’s HTML and caches that data. It serves the cached version on subsequent shares until you force a refresh or the cache expires on its own, typically anywhere from a few hours to several days depending on how active the URL is.

On the first share, Facebook scrapes and caches your tags immediately. Updates you make after that point won’t appear automatically. Here’s what that means in practice:

• If you fix a broken og:image, shares before the re-scrape still show the broken version
• If you update the title or description, old shares are unaffected until the cache clears
• Running the Sharing Debugger and clicking Scrape Again is the only way to force an immediate refresh

One thing that catches people off guard is that Facebook removed the ability to edit link previews directly inside the post composer in 2017. This was a deliberate policy change to prevent clickbait and misinformation. You can’t change the title, image, or description of a shared link by typing in the composer. Every control runs through your page’s Open Graph tags.

Posts with complete, well-sized previews also tend to get better feed distribution. Facebook’s content algorithm responds to engagement signals, and a broken preview suppresses clicks before that process starts.

For content intended to travel, making Facebook posts shareable starts with a preview that gives people a reason to click. A well-formed link card is the baseline.

Conclusion

Getting a Facebook link preview right is mostly a one-time setup problem. Once your Open Graph tags are in place and Facebook has scraped a clean version of your page, the preview handles itself until you change the URL, update the image, or move the page.

A correct, well-sized preview is a small thing to get right and a consistently annoying thing to fix retroactively. Getting it done at the publishing stage is the cleaner move.

Frequently asked questions