Skip to content

LinkedIn metadata: what it is and how link previews use it

3 min read

PostCat AI is an independent product. It is not affiliated with LinkedIn.

LinkedIn metadata is the information LinkedIn reads from a link you share, such as the title of the article or website and a preview image. LinkedIn uses it to build the box that appears under your post. "Metadata" is not a LinkedIn button or setting. It is the word LinkedIn's help pages use for this data.

Where you meet it on LinkedIn

When you paste a link into your post, LinkedIn builds a preview from the site you shared. It may show a thumbnail along with the article or website title, if one is available. You can share either a link or an image in a post, not both at the same time. A preview image should use a 1.91:1 ratio, 1200 x 627 pixels.

On a personal feed, paste the link or type the URL in the What do you want to talk about? field. The sharing steps are in LinkedIn Help: Share an article.

Developers meet the word in Microsoft's API documentation. There, a socialMetadata endpoint returns a summary of a post's social details, such as whether comments are OPEN or CLOSED. Most members never see this.

Start with the page you link to. Most wrong previews come from what the page sends to LinkedIn, not from your post.

  1. Open Post Inspector.
  2. Enter the URL you want to share.
  3. Confirm that the preview window shows the correct content.

Post Inspector can also refresh the URL. The steps and the notes are in LinkedIn Help: Post Inspector.

Keep in mind that a fix only reaches new posts. The preview for any existing post with this URL stays the same. If an old image still appears, LinkedIn may be showing a cached copy.

If you see a "cannot display preview" error, check the landing page's SSL certificate. Also check whether the site has been flagged by a spam or phishing blocklist. Clearing your own browser's cache and cookies can help you see the current page. More checks are in LinkedIn Help: Troubleshooting URL sharing.

If you post for a company Page as a super or content admin, you can change the preview image and title in the post itself. The steps are in LinkedIn Help: Customize a Page post preview.

To see how the words of your post will look in a feed before you publish, try our post preview.

What LinkedIn's documentation does not say

LinkedIn's documentation does not say:

  • Which Open Graph tags LinkedIn reads, or how to write them.
  • How long LinkedIn keeps a link preview in its cache.
  • Whether Post Inspector works in the mobile app, and which fields it shows.
  • Whether personal members, not only Page admins, can change a preview's image or title.
  • What causes a "cannot display preview" error, apart from SSL certificates.
Sources
  • LinkedIn Help: Use Post Inspector to refresh URL
  • LinkedIn Help: Troubleshoot posts on your LinkedIn Page
  • LinkedIn Help: Share articles or links
  • LinkedIn Help: Customize the image and title of a LinkedIn Page post preview
  • LinkedIn Help: Share photos or videos
  • LinkedIn Help: Image specifications for your LinkedIn Pages and Career Pages
  • LinkedIn Help: Contact LinkedIn customer support
  • Social Metadata API - LinkedIn (learn.microsoft.com)
  • LinkedIn API Partner Support - LinkedIn (learn.microsoft.com)
  • LinkedIn Learning Single Sign-On (SSO) Implementation Guide - LinkedIn (learn.microsoft.com)

Frequently asked questions

LinkedIn may show an image that is cached from an earlier share. That cached image is what you see when you add the URL to a new post. Use Post Inspector to refresh the URL, then check the preview window again.

Start with your team's next post.

Connect your team's LinkedIn profiles and start with a free trial.