Microsoft Teams Open Graph

Test and debug your Open Graph tags for Microsoft Teams

Microsoft Teams Specs

Image size1200x630px
Aspect ratio1.9:1
Max file size5 MB
Formatsimage/jpeg, image/png, image/webp, image/gif
User-AgentMozilla/5.0 (compatible; SkypeUriPreview; +https://www.skype.com)

Microsoft Teams generates link unfurl previews when someone pastes a URL in a chat or channel, using a server-side crawler inherited from the Skype era. A major quirk is that Teams prioritizes Twitter Card tags over Open Graph tags when both are present – so twitter:title will override og:title, which catches many developers off guard.

This guide covers how the SkypeUriPreview crawler works, which tags Teams reads (including Schema.org/JSON-LD for richer Adaptive Card previews), image requirements, the 30-minute server-side cache, and the most common issues including corporate firewall problems unique to enterprise deployments.

What links look like on Microsoft Teams

The difference Open Graph tags make when sharing a link.

Without Open Graph
This site doesn't have Open Graph
opengraphplus.com
Microsoft Teams Open Graph
Oh
With Open Graph
Sites with Open Graph look like this
opengraphplus.com
Microsoft Teams Open Graph
Nice!

Debug Microsoft Teams Open Graph tags

Enter your site's URL to see how it looks on Microsoft Teams.