Guide7 min read

LinkedIn Open Graph Tags: The Complete Setup Guide

How to configure Open Graph tags so your links look great on LinkedIn — covering required tags, image specs, caching behavior, and how to force a re-crawl with the Post Inspector.

LinkedIn is one of the most important platforms for sharing professional content, product launches, and blog posts — but it has unique OG tag behavior that trips up developers. LinkedIn ignores all Twitter Card tags entirely, caches previews for up to seven days, and has strict minimum image dimensions. This guide covers exactly what you need to get LinkedIn link previews right.

What LinkedIn Reads (and Ignores)

LinkedIn's crawler, LinkedInBot, reads only the og: namespace. It completely ignores all twitter:* tags — twitter:title, twitter:description, twitter:image, and twitter:card have zero effect on LinkedIn previews. If your page only has Twitter Card tags without og: equivalents, LinkedIn will display a text-only card with no image.

  • og:title — required. LinkedIn uses this as the card headline.
  • og:description — recommended. Displayed below the title in the preview.
  • og:image — required for a visual card. Must be an absolute HTTPS URL.
  • og:url — recommended. LinkedIn uses this for deduplication and share count grouping.
  • og:type — optional but good practice. Use "website" for landing pages, "article" for blog posts.
  • og:site_name — optional. Displayed as a small label above the title.
  • twitter:* tags — completely ignored by LinkedIn.

Minimum Required Tags for LinkedIn

<!-- Minimum for a LinkedIn card with image -->
<meta property="og:title" content="Your Page Title" />
<meta property="og:description" content="A concise 1–2 sentence summary under 300 characters." />
<meta property="og:image" content="https://example.com/og-image.jpg" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="627" />
<meta property="og:url" content="https://example.com/your-page" />
TipAlways include og:image:width and og:image:height. Without explicit dimensions, LinkedIn may fetch the image to determine its size — which is slow and sometimes fails, resulting in no image in the preview.

LinkedIn Image Requirements

LinkedIn has the strictest image size enforcement of any major platform. Images below the minimum are hidden entirely — not shown as thumbnails, not resized, just gone.

  • Recommended size: 1200×627px (1.91:1 aspect ratio)
  • Minimum size: 200×200px — images below this are hidden with no fallback
  • Minimum for large-format card: 600×315px
  • Max file size: 5MB
  • Formats: JPEG or PNG (WebP has inconsistent LinkedIn support)
  • Protocol: HTTPS required — HTTP images are not displayed
  • Access: must be publicly accessible with no authentication

The recommended 1200×627px size uses a 1.91:1 ratio (LinkedIn's native preference). The universal compromise of 1200×630px also works fine — the 3px height difference is invisible in practice.

Full Recommended Tag Set for LinkedIn

<!-- Full OG tag set for optimal LinkedIn preview -->
<meta property="og:title" content="Your Page Title — Under 150 Characters" />
<meta property="og:description" content="A clear, compelling summary. LinkedIn shows approximately 300 characters before truncating." />
<meta property="og:image" content="https://example.com/og-image.jpg" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="627" />
<meta property="og:image:alt" content="Descriptive alt text for accessibility" />
<meta property="og:url" content="https://example.com/your-page" />
<meta property="og:type" content="website" />
<meta property="og:site_name" content="Your Brand Name" />

LinkedIn Article Tags

For blog posts and articles, set og:type to "article" and include article namespace tags. LinkedIn uses these for richer feed presentation of editorial content:

<meta property="og:type" content="article" />
<meta property="article:published_time" content="2026-05-12T09:00:00Z" />
<meta property="article:author" content="https://linkedin.com/in/yourprofile" />
<meta property="article:tag" content="open graph" />
<meta property="article:tag" content="seo" />

LinkedIn's Aggressive Caching

LinkedIn caches OG previews for up to seven days after the first crawl. This is the most aggressive caching of any major social platform. If you fix your OG tags after the URL was first shared, LinkedIn will continue showing the old (broken) preview for up to a week — unless you force a re-crawl.

Common situations where this catches developers off guard:

  • You deploy a new blog post, share it on LinkedIn, realize the og:image was wrong, fix it, but the old broken preview is stuck for days.
  • You update the og:title but LinkedIn keeps showing the old title.
  • You add an og:image that was missing, but LinkedIn still shows a text-only card.
  • You change the image at the same URL — LinkedIn caches the old image, not the new one.

How to Force a LinkedIn Cache Re-Crawl

LinkedIn provides an official tool for forcing a cache re-crawl: the Post Inspector. This is the only reliable way to see the current state of your OG tags on LinkedIn and to clear the cached preview.

  1. 1.Go to linkedin.com/post-inspector (must be logged in).
  2. 2.Enter the full URL of your page.
  3. 3.Click Inspect — LinkedIn fetches your page and shows what it currently reads.
  4. 4.If the preview is outdated, click Regenerate — this forces a fresh crawl and updates the cache.
  5. 5.Wait 1–2 minutes and reload the inspector to see the updated result.
TipThe Post Inspector only re-crawls for new shares made after you clicked Regenerate. Existing LinkedIn posts that already have a cached preview continue to show the old version — the cache is per-URL, not per-post.

LinkedIn OG Tags in Next.js

In Next.js App Router, configure LinkedIn-compatible OG tags using the built-in metadata API. Because LinkedIn ignores twitter:* tags, focus on the openGraph object:

// app/blog/[slug]/page.tsx
import type { Metadata } from 'next'

interface Props {
  params: Promise<{ slug: string }>
}

export async function generateMetadata({ params }: Props): Promise<Metadata> {
  const { slug } = await params
  const post = await getPost(slug)

  if (!post) return { title: 'Not Found' }

  return {
    title: post.title,
    description: post.description,
    openGraph: {
      title: post.title,
      description: post.description,
      url: `https://example.com/blog/${slug}`,
      siteName: 'Your Brand',
      type: 'article',
      publishedTime: post.publishedAt,
      images: [
        {
          url: `https://example.com/blog/${slug}/og.jpg`,
          width: 1200,
          height: 627,
          alt: post.title,
        },
      ],
    },
    // twitter: tags ignored by LinkedIn but needed for X
    twitter: {
      card: 'summary_large_image',
      title: post.title,
      description: post.description,
    },
  }
}

Next.js will automatically inject the og:image:width and og:image:height tags from the images array, and og:type and article:published_time from the article fields — so you get full LinkedIn compatibility with no manual <meta> tags.

Common LinkedIn OG Tag Mistakes

  1. 1.Only setting twitter:image without og:image — LinkedIn ignores twitter:image entirely. Result: text-only card.
  2. 2.Image under 200×200px — LinkedIn hides the image with no warning or fallback.
  3. 3.Relative og:image URL (e.g. /og.jpg) — LinkedIn cannot resolve relative URLs. Always use absolute HTTPS URLs.
  4. 4.Not including og:image:width and og:image:height — may cause layout issues or require LinkedIn to fetch the image to determine size.
  5. 5.HTTP image URL — LinkedIn requires HTTPS images.
  6. 6.og:description over 300 characters — LinkedIn truncates after ~300 characters. Write concise descriptions.
  7. 7.Assuming cache cleared after fixing tags — LinkedIn keeps the old preview for up to 7 days. Use the Post Inspector to force a re-crawl.

Checking What LinkedIn Actually Sees

LinkedIn's crawler (LinkedInBot/1.0) does not run JavaScript. If your OG tags are injected by a React component or set dynamically after page load, LinkedIn will see a page with no meta tags and render a text-only card. You can verify what LinkedIn sees with curl:

# Fetch your page as LinkedInBot and extract OG tags
curl -s -A "LinkedInBot/1.0" "https://example.com/your-page" \
  | grep -i 'og:'

# Expected output (example):
# <meta property="og:title" content="Your Title" />
# <meta property="og:description" content="Your description." />
# <meta property="og:image" content="https://example.com/og.jpg" />

# If this returns nothing, LinkedIn sees no OG tags.
# If og:image is missing, LinkedIn will show a text-only card.

OGProof runs this check automatically for all six platforms — including LinkedIn — in a single pass. It fetches your URL with the LinkedInBot user-agent, extracts all og: tags, and renders an accurate visual preview of what LinkedIn will display. It also flags issues like missing og:image, image too small, og:description over the truncation threshold, and HTTPS violations.

LinkedIn OG Tag Checklist

  • og:title — present, under 150 characters
  • og:description — present, under 300 characters
  • og:image — absolute HTTPS URL, minimum 200×200px, ideally 1200×627px
  • og:image:width and og:image:height — always include
  • og:url — set to the exact canonical URL
  • og:type — "website" or "article"
  • og:site_name — your brand name
  • No twitter:image as a substitute for og:image — LinkedIn ignores it
  • After fixing tags: use the LinkedIn Post Inspector to force a re-crawl
  • Validate with OGProof to confirm LinkedIn sees the correct tags server-side

Validate your OG tags now

Paste any URL and see exactly how it renders on Twitter, LinkedIn, Facebook, Discord, Slack, and iMessage — in seconds.

Try OGProof free →