Configure display settings in Windows App

Important

Windows App is currently in PREVIEW. This information relates to a prerelease product that may be substantially modified before it's released. Microsoft makes no warranties, expressed or implied, with respect to the information provided here.

Once you're connected to your devices and apps using Windows App, it's important to know how to use its features and configure settings. This article shows you how to configure display settings, such as multiple displays, display resolutions, and scaling for devices in Windows App.

Prerequisites

Before you can configure display settings, you need:

• Windows App installed on your local device, or access to Windows App in a web browser, with at least one device or app added. To learn more, see Get started with Windows App

Display settings

Select a tab for the platform you're using.

Windows

Here are the display settings you can configure in Windows App for Windows.

Set custom display settings

If you want to use different display settings to the default settings or settings specified by your admin, you can configure custom settings by following these steps. You can only configure custom settings for devices, not apps.

1. Open Windows App, select the Devices tab, then find the device you want to configure custom display settings for.

2. Select the ellipses (...) on the card of the device, then select Settings.

3. Toggle Use default settings to off.

4. For Display Settings, you can select the following options:

   Display configuration	Description
   All displays	Automatically use all displays for the device. If you have multiple displays, all of them are used.
   Single display	Only a single display is used for the device.
   Select displays	Only select displays are used for the device.

   Each display configuration in the previous table has its own settings. Use the following table to understand each setting:

   Setting	Display configurations	Description
   Single display when in windowed mode	All displays Select displays	Only use a single display when running in windowed mode, rather than full screen.
   Start in full screen	Single display	The device is full-screen.
   Fit session to window	All displays Single display Select displays	When you resize the window, the scaling of the device automatically adjusts to fit the new window size. The resolution stays the same.
   Update the resolution on resize	Single display	When you resize the window, the resolution of the device automatically changes to match. If this setting is disabled, a new option for Resolution is displayed where you can select from a predefined list of resolutions.
   Choose which display to use for this session	Select displays	Select which displays you want to use. All selected displays must be next to each other.
   Maximize to current displays	Select displays	The device shows full-screen on the current display(s) the window is on, even if display isn't selected in the settings. If this setting is off, the device shows full-screen on the same display(s) regardless of the current display the window is on. If your window overlaps multiple displays, those displays are used when maximizing the device.

Light mode and dark mode

You can change Windows App between light mode and dark mode, or use the mode your device is configured to use in your system settings. To change between light mode and dark mode:

1. Open Windows App.

2. Select the cog icon for Settings.

3. In the section General, select the drop-down menu for Choose your mode.

4. Tap Light, Dark, or Use system settings. The change takes effect immediately.

macOS

Here are the display settings you can configure in Windows App for macOS.

Set custom display settings

If you want to use different display settings to the default settings or settings specified by your admin, you can configure custom settings by following these steps. You can only configure custom settings for devices, not apps.

1. Open Windows App, select the Devices tab, then find the device you want to configure custom display settings for.

2. Select the ellipses (...) on the card of the device, then select Edit.

3. Check the box for Use custom settings. This check box isn't applicable for remote PCs.

4. On the Display tab, you can select from the following options:

   Option	Description
   Resolution	Select the resolution to use for the device. You can select from a predefined list, or add custom resolutions. This setting is only available when Use all monitors, Optimize for Retina displays and Update the session resolution on resize are unchecked.
   Use all monitors	Automatically use all displays for the device. If you have multiple displays, all of them are used.
   Start session in full screen	When checked, the device is displayed full-screen. When unchecked, the device is displayed in a window.
   Fit session to window	When you resize the window, the scaling of the device automatically adjusts to fit the new window size. The resolution stays the same.
   Color quality	The quality and number of colors used. Higher quality uses more bandwidth.
   Optimize for Retina displays	Scale the device to match the scaling used on the Mac client. This uses four times more bandwidth.
   Update the session resolution on resize	When you resize the window, the resolution of the device changes automatically to match.

Add, remove, or restore display resolutions

To add, remove or restore display resolutions:

1. Open Windows App.

2. From the macOS menu bar, select Windows App, then select Settings.

3. On the Preferences pane, select the Resolutions tab.

4. To add a custom resolution, select the + (plus) icon and enter values in the fields for Width and Height in pixels, then select Add.

5. To remove a resolution, select the resolution you want to remove, then select the - (minus) icon. Confirm that you want to delete the resolution by selecting Delete.

6. To restore the default resolutions, select Restore Defaults.

Displays have separate Spaces

macOS enables you to create extra desktops, called Spaces, where only the Windows that are in that space are visible. The macOS setting Displays have separate Spaces, which can be found in your Mac's Mission Control system settings, controls whether each display has its own Spaces, or if all displays share the same Spaces.

When you use multiple displays, this setting can cause some displays to be blank in certain scenarios. If Displays have separate Spaces is disabled and Windows App has Start session in full screen enabled, but Use all monitors disabled, only one display is used and the others are blank. Either enable Displays have separate Spaces in Mission Control so a device in Windows App is displayed full-screen on one display, with others showing the macOS desktop, or enable Use all monitors so the device in Windows App is displayed on all displays.

Sidecar

You can use Apple Sidecar during a remote session, allowing you to extend a Mac desktop display using an iPad as an extra display.

iOS/iPadOS

Here are the display settings you can configure in Windows App for iOS and iPadOS.

Set display settings

All devices and apps use the same display settings. You can't set custom display settings per device or app. To set display settings:

1. Open Windows App.

2. Tap the cog icon for Settings, or tap your user account picture to open the settings pane.

3. Tap Display.

4. Tap a resolution from the list of available resolutions.

5. Toggle Use Full Display to on to use the full display of your device.

Light mode and dark mode

You can change Windows App between light mode and dark mode, or use the mode your device is configured to use in your iOS or iPadOS settings. To change between light mode and dark mode:

1. Open Windows App.

2. Tap the cog icon for Settings, or tap your user account picture to open the settings pane.

3. Tap General, then tap Appearance.

4. Tap Light, Dark, or System. The change takes effect immediately.

Display auto-lock

You can configure whether your device should keep the display on, or be allowed to automatically lock as configured in your iOS or iPadOS settings. To configure display auto-lock:

1. Open Windows App.

2. Tap the cog icon for Settings, or tap your user account picture to open the settings pane.

3. Tap General.

4. Toggle Allow Display Auto-Lock to on to allow your device to automatically lock, or off to keep the display on.

External displays

iPhone and iPad support an external display using a wired connection or AirPlay. How Windows App uses the external display depends on your device and its settings. The resolution used for external displays is limited by your device. For more information, see Charge and connect with the USB-C port on your iPad and Charge and connect with the USB-C connector on your iPhone.

• iPad with Stage Manager enabled: when you use a wired connection, you can use the external display for the remote session while using your iPad with other apps, including multi-tasking, windows resizing, and dynamic resolution across the iPad and external display. When you use AirPlay, the remote session is shown on the external display at its native resolution.

• iPad without Stage Manager: when you use a wired connection or AirPlay, the remote session is shown on the external display at its native resolution. You can use Windows App as a trackpad to control the mouse pointer on the external display. Keyboard, mouse, trackpad, and touch input are automatically mapped to your external display and its resolution. You can use mouse, trackpad, and touch input simultaneously.

• iPhone: when you use a wired connection or AirPlay, the remote session is shown on the external display at its native resolution. You can use Windows App as a trackpad to control the mouse pointer on the external display. Mouse support on iPhone through AssistiveTouch isn't supported on an external display. The SwiftPoint GT mouse or ProPoint GT mouse are supported on an external display. Ensure your Swiftpoint mouse is selected as an input device in Windows App by following the steps in Use keyboard, mouse, touch, and pen in Windows App.

Web browser

Here are the display settings you can configure in Windows App in a web browser. Display settings are only available to configure once you're connected to a remote session.

Full screen

You can display your remote session full-screen from your web browser. To enter and exit full screen:

1. Sign in to Windows App using your web browser.

2. Connect to a device.

3. On the toolbar of the session, select the diagonal arrows icon for Full screen.

4. To exit full screen, select the diagonal arrows icon for Exit full screen. On Windows, you can also press Esc on your keyboard, or on macOS, you can also press and hold Esc on your keyboard to exit full screen.

Enable higher screen resolution

If you're using a display with a high resolution (also known as high dots per inch, or high DPI), you can configure Windows App to use a higher resolution for the remote session. Using a native resolution can provide higher-fidelity graphics and improved text clarity.

To enable higher screen resolution:

1. Sign in to Windows App using your web browser.

2. Connect to a device.

3. On the toolbar of the session, select the cog icon for In session configuration.

4. Toggle Enable High DPI to on.

5. Select Update. The change is applied immediately.

Note

Enabling higher screen resolution with a high-DPI display may cause increased CPU or network usage.

Light mode and dark mode

You can change between light mode (default) and dark mode for the web portal of Windows App. It doesn't pass through the setting to your devices and apps, so you'll need to configure those separately. To change the web portal between light mode and dark mode:

1. Sign in to Windows App using your web browser.

2. Select the cog icon for Settings

3. Toggle Dark Mode to On to use dark mode, or Off to use light mode. The change takes effect immediately.

Related content

Learn more about how to use Windows App:

• Device actions
• Manage user accounts
• Use keyboard, mouse, touch, and pen
• Redirect local devices, audio, and folders