OG & Social Previews
When someone shares a Tolinku link on social media, messaging apps, or Slack, the platform that receives the link fetches Open Graph (OG) tags to generate a preview card. You can control exactly what that preview looks like.
How OG tags are resolved
Section titled “How OG tags are resolved”Tolinku uses a cascade to determine which OG tags to use:
- Route-level OG tags (if set on the route)
- Auto-fetched OG tags (if the “fetch from fallback URL” option is enabled)
- Appspace-level OG tags (the defaults set in App Config)
If none are configured, the link preview will be blank or will show whatever the destination page provides.
Setting OG tags on a route
Section titled “Setting OG tags on a route”In the route form, expand Advanced Settings to find the OG fields:
- OG Title: The headline shown in the preview card. Keep it under 70 characters.
- OG Description: The body text below the title. Keep it under 200 characters.
- OG Image: Upload an image or provide a URL. Recommended size: 1200x630 pixels for best display across platforms.
Auto-fetch from fallback URL
Section titled “Auto-fetch from fallback URL”If you already have OG tags on your website and don’t want to duplicate them, enable Auto-fetch OG tags on the route. When this is on, Tolinku scrapes the OG tags from your web fallback URL and uses those for link previews.
This is useful when your route’s fallback URL is a product page, blog post, or landing page that already has well-configured OG tags.
Platform-specific behavior
Section titled “Platform-specific behavior”Different platforms render OG tags slightly differently:
| Platform | Image ratio | Title length | Notes |
|---|---|---|---|
| Facebook / Meta | 1.91:1 (1200x630) | ~60 chars | Truncates long titles |
| Twitter / X | 2:1 (1200x600) | ~70 chars | Uses twitter:card meta if present |
| 1.91:1 (1200x627) | ~70 chars | Caches previews aggressively | |
| Slack | 1.91:1 | ~70 chars | Shows inline preview |
| iMessage | Square crop | Full title | Shows smaller thumbnail |
| 1.91:1 | ~60 chars | Caches for ~7 days |
For the best results across all platforms, use a 1200x630 image and keep your title under 60 characters.
Debugging previews
Section titled “Debugging previews”If your link preview doesn’t look right:
-
Check the OG tags: Visit your Tolinku link in a browser and view the page source. Look for
<meta property="og:title">,og:description, andog:imagetags. -
Clear platform caches: Most platforms cache OG data. Use their debug tools to refresh:
- Facebook: Sharing Debugger
- Twitter: Card Validator
- LinkedIn: Post Inspector
-
Check image accessibility: The OG image URL must be publicly accessible. If it returns a 404 or requires authentication, the preview will be blank.