When you paste a link into a Bluesky post, the app usually generates a preview card with a title, description, and image. Sometimes this preview fails to appear, leaving only a bare URL. This happens because Bluesky’s link preview service cannot fetch the Open Graph metadata from the target website or because your post contains conflicting formatting. This article explains why link previews fail and provides step-by-step fixes you can apply immediately.
Key Takeaways: Fixing Bluesky Link Previews
- Paste the URL on its own line: Removing surrounding text or formatting forces the preview to generate.
- Delete and repaste the link: A fresh paste triggers a new fetch of the Open Graph data.
- Use a URL shortener or direct link: Some sites block Bluesky’s crawler; a shorter URL may bypass the restriction.
Why Bluesky Fails to Generate a Link Preview
Bluesky generates link previews by sending a request to the target website and reading its Open Graph tags. These tags are HTML meta elements that specify the title, description, and image for a link. If the website does not include these tags, or if it blocks Bluesky’s user agent, the preview will not appear. Another common cause is that the URL is pasted inside a block of text, such as within a sentence or after a word. Bluesky’s parser expects the URL to be isolated on its own line to trigger the preview fetch. Finally, the preview service may be temporarily down or rate-limiting your account.
There are no settings inside Bluesky to enable or disable link previews. The feature runs automatically when you paste a URL. However, you can influence whether a preview appears by how you paste the link and by the order in which you compose the post.
Steps to Force a Link Preview to Appear
- Paste the URL on a blank line
Open the Bluesky app or website and start a new post. Type nothing else. Paste the URL onto an empty line, then press Enter to move to a new line. Add your commentary below the URL. This isolation forces Bluesky to treat the URL as a separate element and attempt a preview fetch. - Delete and repaste the link
If the preview still does not appear, delete the entire URL from the post box. Wait five seconds. Paste the same URL again on a blank line. This action sends a new fetch request to the website. - Remove any formatting around the URL
Bluesky supports rich text formatting including bold, italic, and strikethrough. If you applied any formatting to the URL text, remove it. Select the URL and click the formatting icon to clear all styles. A plain, unformatted URL is required for the preview to generate. - Check the target website manually
Open the URL in a browser. Right-click the page and select View Page Source. Search forog:titlein the source code. If you find no Open Graph tags, the website does not support link previews. Bluesky cannot generate a preview for such pages. You can still share the link, but no card will appear. - Use a URL shortener as a workaround
If the website blocks Bluesky’s crawler, copy the URL into a shortener service such as Bitly or TinyURL. Paste the shortened URL on a blank line in Bluesky. The shortener’s redirect page usually includes Open Graph tags, which allows Bluesky to generate a preview. - Restart the Bluesky app
On mobile, force-close the Bluesky app. On iOS, swipe up from the bottom and swipe the Bluesky card away. On Android, open the app switcher and swipe Bluesky away. Reopen the app, create a new post, and paste the URL on a blank line. This clears any temporary cache that may be preventing the preview fetch. - Wait and try again later
Bluesky’s link preview service may be experiencing a temporary outage. Wait 15 to 30 minutes, then repeat the process. You can check Bluesky’s status page at status.bsky.app for known issues.
If the Link Preview Still Does Not Appear
“The preview appears for other links but not for this specific URL”
The target website may have a rate limit that blocks Bluesky’s IP address after a certain number of requests. Wait one hour before trying the same URL again. Alternatively, the website may have changed its Open Graph tags after you first copied the link. Copy the URL fresh from the address bar and paste it again.
“The preview image is missing or shows the wrong picture”
Bluesky uses the og:image tag from the website. If the website uses a small image or a relative URL path, Bluesky may discard it. You cannot manually choose a different image. If the preview shows an unrelated image, the website’s Open Graph tags are misconfigured. Contact the website owner to fix the tags.
“The preview shows a different title or description than expected”
This happens when the website uses dynamic Open Graph tags that change based on user agent or time of access. Bluesky caches the preview for a period. To force a fresh cache, append a query string to the URL, such as ?refresh=1. This makes the URL appear new to Bluesky, triggering a new fetch.
“Pasting a link inside a thread or reply does not generate a preview”
Bluesky generates link previews only in top-level posts, not in replies or thread continuations. If you paste a URL into a reply, it will appear as plain text. To share a link with a preview, create a new post and paste the URL there.
| Issue | Likely Cause | Fix |
|---|---|---|
| No preview at all | URL pasted inside text or formatted | Paste on a blank line with no formatting |
| Preview shows wrong content | Website Open Graph tags are outdated or dynamic | Append a query string to force a fresh fetch |
| Preview works on desktop but not mobile | Mobile app cache issue | Force-close the app and reopen |
| Preview never appears for any link | Bluesky service outage | Check status.bsky.app and wait |
Bluesky link previews are a convenient way to share content with context. By isolating the URL on its own line and removing formatting, you can trigger the preview in most cases. If a specific website consistently fails, use a URL shortener as a reliable workaround. For advanced troubleshooting, check the Bluesky status page and consider appending a query string to force a fresh cache.