How do I update the thumbnail in a URL preview on Teams?

Question

Hi,

I’m having an issue with the thumbnail preview that appears when sharing a link in Microsoft Teams.

The correct Open Graph image is set here: pii removed

However, Teams is not displaying this image.

Teams (Web) preview: pii removed

Teams (Desktop App) preview: (broken image) pii removed

The Open Graph Meta Tags on the site are correctly configured, including:

<meta property="og:locale" content="en_US" />
<meta property="og:type" content="website" />
<meta property="og:title" content="pii removed" />
<meta property="og:description" content="pii removed!" />
<meta property="og:url" content="https://pii removed/" />
<meta property="og:site_name" content="pii removed" />
<meta property="article:modified_time" content="2025-11-25T20:13:44+00:00" />
<meta property="og:image" content="https://pii removed/wp-content/uploads/2025/11/2026-pii removed-logo-1200x628-1.jpg" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="628" />
<meta property="og:image:type" content="image/jpeg" />

Despite clearing caches (browser, Teams app, WordPress caching, and Elementor files), Teams continues to show the old thumbnail or a broken image.

Could you please advise on how to force Teams to refresh its preview cache or help troubleshoot why Teams is not pulling the current Open Graph image?

Thank you,

Answer 1

Please note that our forum is a public platform, and we will modify your question to hide your personal information in the description. Kindly ensure that you hide any personal or organizational information the next time you post an error or other details to protect personal data.

Hi Joevil Malones

Thank you for reaching out to Microsoft Q&A forum and apologize for the delayed response

Based on your description and screenshot, when you paste certain links in Microsoft Teams, the preview unfurls with title/description, but the thumbnail image is missing or appears broken.

As far as I know, Teams builds preview cards by fetching Open Graph/Schema.org metadata (including og:image) or by using micro‑capabilities for website links. If the site’s image host is blocked, the preview service is disabled by policy, or the client cache holds a stale/bad result, the thumbnail won’t load even though text unfurls

Therefore, you can try to follow the below instructions to see if the issue still persists:

1/ Verify that URL previews are allowed for the user

In Teams admin center → Messaging policies, ensure Allow URL previews is enabled for the policy assigned to the affected users; or set via PowerShell:

Set-CsTeamsMessagingPolicy -Identity "<PolicyName>" -AllowUrlPreviews $true

2/ Confirm Optional Connected Experiences aren’t disabled

Teams’ URL Preview is an optional connected experience, if it disabled by Cloud Policy or by the user, previews (especially images fetched from third‑party domains) can be suppressed. Check Teams → Settings → Privacy and your Cloud Policy setting: “Allow the use of additional optional connected experiences in Office."

3/ If you control the target website

Kindly provide robust metadata Ensure public (unauthenticated) access to a valid og:image (recommended ~1200×630, JPEG/PNG) and consider Schema.org micro‑capabilities via JSON‑LD for consistent rich unfurls in Teams.

In some cases, it’s possible for the URL preview to appear and disappear intermittently. This screenshot was taken in my test environment, so it might be a temporary problem related to the Teams backend. What you can try is completely quitting Teams (via Task Manager), logging out, and then signing back in to see if the problem gets resolved.

---

Hope my answer will help you, for any further concern, kindly let me know in the comment section.

Best regards.

---

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".     

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

 

Answer 2

[Moderator note: personal info removed]

Hi Steven,

Thank you for your response.

In the Teams app, the correct thumbnail appears when I add a query parameter to the URL (v=2): PII removed. However, without the parameter, it shows a broken image: PII removed.

The same happens on the web: with the parameter, the correct thumbnail displays: PII removed, but without it, the old thumbnail shows: PII removed.

Could you clear the cache on your end?

Thanks,