Microsoft Teams Open Graph
Test and debug your Open Graph tags for Microsoft Teams
Microsoft Teams Specs
| Image size | 1200x630px |
| Aspect ratio | 1.9:1 |
| Max file size | 5 MB |
| Formats | image/jpeg, image/png, image/webp, image/gif |
| User-Agent | Mozilla/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.