Refresh Social Card Caches

3 min

The problem

Social platforms cache link previews for performance. When you update your ogli.sh link's image or text, platforms might still show the old preview.

1) Use platform debug tools

Facebook/Meta (Instagram, WhatsApp, Messenger)

Go to Facebook Sharing Debugger
Paste your ogli.sh link
Click "Debug"
Click "Scrape Again" to refresh cache

Twitter/X

Go to Twitter Card Validator
Paste your ogli.sh link
Click "Preview card"
Cache refreshes automatically

Go to LinkedIn Post Inspector
Paste your ogli.sh link
Click "Inspect"
Cache updates immediately

2) Change your image URL

The most reliable method - add a version parameter:

# Update your link with versioned image URL
curl -X PATCH https://api.ogli.sh/link/YOUR_LINK_ID \
  -H "Authorization: Bearer $OGLI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ogImage": "https://cdn.example.com/image.jpg?v=2"
  }'

3) Re-share your link

Share the link in a new post/message
Don't edit existing posts (cache won't refresh)
New shares will show the updated preview

Platform cache duration

Facebook: 24 hours (or until manually refreshed)
Twitter: 7 days (updates faster with Card Validator)
LinkedIn: 7 days (or until manually refreshed)
Slack: ~30 minutes
Discord: ~1 hour
WhatsApp: 24 hours (same as Facebook)

Pro tips

Test first: Use debug tools before sharing widely
Version images: Always use ?v=1, ?v=2 etc.
Wait for old posts: Existing shares won't update automatically
Slack/Discord: Just wait, they refresh automatically
Plan ahead: Get the preview right before mass sharing

Quick debug URLs

Facebook: https://developers.facebook.com/tools/debug/?q=YOUR_OGLI_LINK
Twitter: https://cards-dev.twitter.com/validator
LinkedIn: https://www.linkedin.com/post-inspector/inspect/YOUR_OGLI_LINK

← Back to all how-tos