LinkedIn Post Image Placeholders for Blogs and Docs

How it works

How LinkedIn reads og:image for link previews

LinkedIn's crawler reads og:image from the HTML at the shared URL. Unlike X/Twitter, LinkedIn does not support a LinkedIn-specific image meta tag — og:image is the only hook you have.

The crawler fetches and caches the image at share time. If the URL is not publicly accessible, returns an error status, or points to an SVG, LinkedIn will not display a preview image. Cached previews persist until you manually refresh them through LinkedIn's Post Inspector tool.

One frequent failure: images behind a CDN that requires a signed URL or a session cookie. LinkedIn's crawler has no session context, so any image requiring authentication silently fails.

Dimensions

LinkedIn image size for posts and articles

For shared link previews — the kind generated when you paste a URL into a LinkedIn post — the recommended image size is 1200×627 pixels. LinkedIn crops images to approximately 1.91:1 in the card display.

For LinkedIn Articles, the cover image displays at 744×400 in the editor preview, but upload at least 1200×644 for sharp display on high-DPI screens.

PNG and JPEG are the safe choices. WebP works in most cases but has had inconsistent support across LinkedIn's crawler versions. Avoid GIF (only the first frame is used) and avoid SVG entirely.

<meta property="og:image" content="https://fallback.pics/api/v1/1200x627.jpg?text=Your+Post+Title" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="627" />
<meta property="og:image:type" content="image/jpeg" />

Fallback strategy

Generate og:image fallbacks when no featured image exists

Most blog and documentation platforms allow you to skip the featured image field. The result on LinkedIn is a card with no visual. Prevent that by substituting a generated URL whenever the field is empty.

Use the fallback.pics thumbnail route for blog posts to get a preview that includes the post title. For technical documentation pages, a plain dimension URL with a branded color is sufficient.

// Astro / Next.js / any template
const ogImage = post.featuredImage
  ?? `https://fallback.pics/api/v1/1200x627.jpg?text=${encodeURIComponent(post.title)}`;

// Docs pages without a meaningful title
const ogImage = page.coverImage
  ?? 'https://fallback.pics/api/v1/1200x627/7C3AED/FFFFFF?text=Documentation';

CMS workflows

LinkedIn fallbacks in WordPress, Ghost, and headless CMS

In WordPress with Yoast SEO, the Social tab lets you override the OG image per post. For a global fallback, set a default image in SEO > Social > Facebook settings — LinkedIn uses the same og:image tag.

In Ghost, the {{facebook_image}} helper provides the og:image value for social sharing. Wrap it in an #if conditional and substitute a generated URL when no image is set.

In Contentful or a similar headless CMS, query the image field with optional chaining and compute the fallback server-side before rendering the page head.

Debugging

Use LinkedIn Post Inspector to refresh stale previews

LinkedIn caches og:image at first-share time. If you update the image after the URL has already been shared, the cached version persists. LinkedIn's Post Inspector (linkedin.com/post-inspector/) lets you re-fetch the URL and clear the preview cache.

Common reasons a preview fails: the URL returns an HTTP redirect chain before the final image, the image is served with a Cache-Control: no-store header, or the og:image URL is relative rather than absolute.

If the Post Inspector shows the correct image but LinkedIn posts still show a broken card, check whether your page returns a 200 status. A redirect to a login wall or a maintenance page causes the crawler to read the wrong HTML head.

Quick reference

LinkedIn image sizes at a glance

Reference these when setting up LinkedIn og:image templates across different content types.

Further reading

Related social image patterns

Twitter Cards and LinkedIn previews share most of the same og:image constraints. A single well-formed og:image tag handles LinkedIn, X, Slack, and Discord in most cases.

https://fallback.pics/docs/
https://fallback.pics/placeholder-image-api/
https://fallback.pics/blog/twitter-card-image-fallbacks/
https://fallback.pics/blog/og-image-placeholders-blogs-docs-social-sharing/