LinkedIn metadata: what it is and how link previews use it
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.
Fix a wrong link preview
Start with the page you link to. Most wrong previews come from what the page sends to LinkedIn, not from your post.
- Open Post Inspector.
- Enter the URL you want to share.
- 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)


