Why Your Link Preview Looks Broken on Slack, Discord, or X

Most broken link previews are not design problems. They are metadata, caching, or image-delivery problems.

The image is the wrong shape

A standalone logo is rarely a good preview image. Use a 1200x630 canvas for the default Open Graph image, then create platform-specific variants only when the crop demands it.

The crawler cannot fetch the image

Social crawlers need a public, absolute image URL. Avoid local paths, blocked assets, huge files, redirect loops, and images that require cookies or authentication.

The old preview is cached

Slack, Discord, X, LinkedIn, and Facebook may keep the first version they saw. When you update metadata, refresh the platform cache or test with a new URL.

The metadata is split across pages

Make sure the canonical page has the title, description, and image tags you expect. Preview crawlers often do not follow your client-side app state the way a person does.

Keep working

OG Image Generator · Twitter Card Generator · LinkedIn Image Generator