Guide

Teams Rooms XML Config (SkypeSettings.xml) Guide

Updated

SkypeSettings.xml is the configuration file that Teams Rooms on Windows reads to apply settings in bulk: the resource account, dual-screen mode, themes and custom backgrounds, meeting join options, content sharing behavior and more. You place it in the Teams Rooms app's LocalState folder; the app applies it at the next restart and then deletes the file. It applies only to Teams Rooms on Windows, not Android devices.

Teams Rooms XML Config (SkypeSettings.xml) Guide
SkypeSettings.xml configures Teams Rooms on Windows: file location, common settings (dual screen, themes, join options), an example file and how to deploy it.

File location

C:\Users\Skype\AppData\Local\Packages\Microsoft.SkypeRoomSystem_8wekyb3d8bbwe\LocalState\SkypeSettings.xml

Any custom background images referenced in the file go in the same folder. The file name must be exactly SkypeSettings.xml.

How it works

  1. You copy SkypeSettings.xml (and any images) to the LocalState folder.
  2. On restart, the Teams Rooms app reads the file and applies the settings.
  3. The app deletes the file after applying it, so settings changed later on the console aren't overwritten on every boot.
  4. To change settings again, deliver a new file.

If a setting isn't applied, the XML is usually malformed. Validate it before deploying; one bad tag can stop the whole file from being read.

Common settings

Element What it controls
<UserAccount> Resource account sign-in (address, password); use with care since it's stored in plain text until applied
<DualScreenMode> true for two front-of-room displays
<DuplicateIngestDefault> Show HDMI content on both displays in dual-screen mode
<Theming> Theme or custom background; see Teams Rooms custom background
<SendLogs> Email address and consent for sending logs
<IsTeamsDefaultClient> Teams as the default meeting client
<TeamsMeetingsEnabled> Allow Teams meetings
<WebexMeetingsEnabled> / <ZoomMeetingsEnabled> Direct guest join to Webex and Zoom; see joining Zoom or Meet from a Teams Room
<AutoAcceptProximateMeetingInvitations> Auto-accept proximity-based meeting joins
<Devices> Default microphone, speaker, camera and content camera names

Microsoft's article "Manage a Microsoft Teams Rooms console settings remotely with an XML configuration file" on learn.microsoft.com lists every supported element. New elements are added with app releases, so check the current list before using one.

Example SkypeSettings.xml

<SkypeSettings>
  <DualScreenMode>true</DualScreenMode>
  <DuplicateIngestDefault>false</DuplicateIngestDefault>
  <IsTeamsDefaultClient>true</IsTeamsDefaultClient>
  <TeamsMeetingsEnabled>true</TeamsMeetingsEnabled>
  <ZoomMeetingsEnabled>true</ZoomMeetingsEnabled>
  <WebexMeetingsEnabled>true</WebexMeetingsEnabled>
  <Theming>
    <ThemeName>Custom</ThemeName>
    <CustomBackgroundMainFoRDisplay>Main.jpg</CustomBackgroundMainFoRDisplay>
    <CustomBackgroundExtendedFoRDisplay>Extended.jpg</CustomBackgroundExtendedFoRDisplay>
  </Theming>
</SkypeSettings>

Leave out any element you don't want to change. Omitted settings keep their current value.

How to deploy the XML file

One room:

  1. On the console, go to More > Settings, enter the admin password, and switch to Windows as Admin.
  2. Copy the file (USB drive or network share) to the LocalState folder.
  3. Switch back to the Teams Rooms app and restart the device.

Many rooms:

What about Android?

Teams Rooms on Android devices don't use SkypeSettings.xml. Configure them in the Teams admin center and the device maker's management tools. See Teams Rooms on Windows vs Android.

Standardizing settings across rooms? Tell us your room count and we'll help plan a consistent rollout.

Related guides

All teams, zoom and meet guides →

Outfitting several rooms, or reselling? Get a volume quote or apply for wholesale pricing →

Popular right now

Popular picks

Get a quote