Teams Rooms on Windows can show your own background image on the front-of-room display and touch console. You need a Teams Rooms Pro license, images that meet Microsoft's size requirements (at least 1920 x 1080 for the room display), and a <Theming> section in the room's XML configuration file pointing to the image files. Teams Rooms Basic rooms can only use the built-in backgrounds.
Requirements
| Requirement | Detail |
|---|---|
| Platform | Teams Rooms on Windows (this method) |
| License | Teams Rooms Pro (Basic: built-in backgrounds only; legacy Standard/Premium supported) |
| File type | JPG, JPEG or PNG |
| Minimum size | 1920 x 1080 for front-of-room displays, 1280 x 800 for the touch console |
| Delivery | Image files copied to the device, enabled through XML |
Check the room's license on the device under More > Settings > Room License, or in the Teams Rooms Pro Management portal.
Image sizes
| Display | Aspect ratio | Recommended resolution |
|---|---|---|
| Front-of-room display (each) | 16:9 1080p | 1920 x 1080 |
| Front-of-room display (each) | 16:9 4K | 3840 x 2160 |
| Front-of-room display | 21:9 1080p | 2560 x 1080 |
| Front-of-room display | 21:9 4K | 3840 x 1645 |
| Touch console | 16:10 | 1280 x 800 |
| Touch console | 16:9 | 1920 x 1080 |
Images larger than recommended may be center-cropped. Images below the minimum are rejected and the room falls back to "No Theme."
Use Microsoft's theme template
Microsoft publishes the Microsoft Teams Rooms Theme Template (a .PSD file) on the Microsoft Download Center. Open it in Photoshop or another editor that reads PSD files. It marks the zones where the room UI draws on top of your image:
- Upper left: clock and room name.
- Lower left: tips.
- Right side: the room calendar.
Keep logos and text out of those zones, use darker tones behind the white text in the left corners, and keep enough contrast for readability.
Single and dual displays
- Single display: one front-of-room image.
- Dual display: one image per display. The main (right) display shows the calendar; the extended (left) display shows date, time and room info. If either front-of-room image is missing, all displays fall back to "No Theme."
- Console: optional image for the touch console.
Enable the background with XML
Add a <Theming> block to the room's SkypeSettings.xml:
<SkypeSettings>
<Theming>
<ThemeName>Custom</ThemeName>
<CustomBackgroundMainFoRDisplay>Contoso-Main.jpg</CustomBackgroundMainFoRDisplay>
<CustomBackgroundExtendedFoRDisplay>Contoso-Extended.jpg</CustomBackgroundExtendedFoRDisplay>
<CustomBackgroundConsole>Contoso-Console.jpg</CustomBackgroundConsole>
</Theming>
</SkypeSettings>
CustomBackgroundExtendedFoRDisplay is required only for dual-display rooms. The older <CustomThemeImageUrl> element still works for a single front-of-room image, but the newer elements take precedence.
Deploy it
- Copy the image files to
C:\Users\Skype\AppData\Local\Packages\Microsoft.SkypeRoomSystem_8wekyb3d8bbwe\LocalState(by USB drive or the device's network share), or deliver them with your management tool. - Put the
SkypeSettings.xmlfile in the same folder. - Restart the device. The app reads the XML on startup and applies the theme.
For many rooms, push the files and XML with Intune, a script, or the Pro Management portal. See Teams Rooms XML config and managing Teams Rooms with Intune.
Teams Rooms on Android
Android devices don't use SkypeSettings.xml. Theme and background options there depend on the Teams Rooms on Android app version and the device maker, and are managed through the Teams admin center. See Teams Rooms on Android.
Not the same as a meeting background
A room theme is the home-screen wallpaper. In-meeting background effects (blur or replacement behind the people in the room) are a separate camera feature. See Teams Rooms digital signage if you want rotating content on the screen between meetings.
Rolling out branded rooms? Talk to us about Teams Rooms Pro devices that support custom themes.
Related guides
- How to Reset or Recover a Microsoft Teams Rooms Device
- How to Set Up Microsoft Teams Rooms: Step by Step
- Managing Teams Rooms with Intune and Autopilot
- Microsoft Teams Rooms requirements: hardware and accounts
- Sharing content in Teams Rooms: HDMI and wireless
- Teams Rooms for GCC High and government tenants
Outfitting several rooms, or reselling? Get a volume quote or apply for wholesale pricing →
