⭐ Beginner — No coding experience needed
Social Preview: Catching Bad-Looking Shares Before They Happen
Learn how to preview exactly how your link will appear on Facebook, LinkedIn, Twitter, Discord and Slack, and how to fix the most common preview problems.
What you will learn in this guide
- How social previews are generated
- Why your preview looks different on each platform
- How to test before publishing
- How to force a cache refresh on Facebook and LinkedIn
- Common preview problems and one-line fixes
1 How previews are generated
When you paste a URL into Facebook, LinkedIn, Twitter, Discord or Slack, each platform fetches your page once, reads the meta tags, and stores a cached preview. The next 30 days of shares use that cached version.
Why this matters:If your OG tags are wrong when someone first shares the URL, the bad preview gets cached and shared by everyone for the next month. Fix before publishing, not after.
2 Test before publishing
- 1Run the Social Preview toolOpen content-tools.html#social-preview and paste your URL. See exact previews for Facebook, LinkedIn, Twitter, Discord, Slack and iMessage.
- 2Check each platform separatelyEach platform uses slightly different aspect ratios and text lengths. A preview that looks fine on Facebook may be cropped weird on Twitter.
- 3Use platform-specific debuggersFacebook Sharing Debugger, LinkedIn Post Inspector, Twitter Card Validator. Each forces a fresh fetch of your URL and shows what their platform sees.
- 4Clear cache after fixingIf you find a problem, fix it, then re-run each debugger to clear the cache before promoting the URL.
3 Common preview problems
| Problem | Likely cause | Fix |
|---|---|---|
| Tiny logo instead of image | Missing og:image | Add og:image with absolute URL |
| Wrong title | og:title missing; using page | Add explicit og:title |
| Image cropped weirdly | Aspect ratio not 1.91:1 (1200x630) | Resize to 1200x630 |
| Old image still shows after edit | Platform cache (30 days) | Use platform debugger to refresh |
| Image not loading | Relative URL or blocked by referrer policy | Use absolute URL; allow social bot user agents |
4 Force a cache refresh
- 1FacebookOpen developers.facebook.com/tools/debug. Paste URL. Click "Scrape Again". Updated immediately on Facebook.
- 2LinkedInOpen linkedin.com/post-inspector. Paste URL. The fetch refreshes LinkedIn's cache.
- 3TwitterTwitter's validator was deprecated; current workaround is post a tweet with a query parameter (e.g., ?v=2) which forces a fresh fetch.
- 4Discord/SlackThese respect OG tags but cache aggressively. Adding a query parameter usually forces a re-fetch.
Cache TTLsFacebook: ~30 days. LinkedIn: ~7 days. Twitter: until you change the URL. Slack: ~24 hours. Discord: until restart.