> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Supporting high DPI displays on PC

> Enable Per-Monitor V2 DPI awareness in your PC title with an assembly manifest so rendering and mouse input work correctly on high-DPI Windows displays.

To help Windows 10 applications and shell elements appear with consistent sizes on monitors of varying pixel densities, Windows has built-in scaling settings. For your title to render and handle mouse input properly when these scaling settings have been adjusted, set the default DPI awareness. Failure to do this can cause your title to display incorrectly, rendering it unusable for players with high DPI displays.

## Enabling high DPI awareness

#### To ensure that your title supports high DPI displays

1. Check the assembly manifest XML of your game executable. This could be titleName.exe, a manifest file alongside titleName.exe, or an embedded manifest in the game executable. You can extract an embedded manifest from your game executable via the command line by using [sigcheck](https://learn.microsoft.com/sysinternals/downloads/sigcheck) (shown as follows).
   ```cpp theme={null}
   sigcheck -m titleName.exe
   ```
2. If you see only the following `<dpiAware>` tag in the manifest XML, high DPI displays aren't supported.
   ```cpp theme={null}
   <windowsSettings>
       <dpiAware>
           true
       </dpiAware>
   </windowsSettings>
   ```
3. The embedded manifest takes precedence over the loose manifest. If that exists, go to step 4. If there's no embedded manifest, create a titleName.exe.manifest file with the following contents.
   ```cpp theme={null}
   <?xml version="1.0" encoding="UTF-8" standlone="yes"?>
   <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
   <application xmlns="urn:schemas-microsoft-com:asm.v3">
       <windowsSettings>
           <dpiAwareness xmlns="https://schemas.microsoft.com/SMT/2016/WindowsSettings">
               PerMonitorV2
           </dpiAwareness>
       </windowsSettings>
   </application>
   </assembly>
   ```
4. If there's an embedded manifest, locate it via the command line by using the following [Mt.exe](https://learn.microsoft.com/windows/win32/sbscs/mt-exe) tool from the Windows SDK.
   ```cpp theme={null}
   mt -inputresource:<titleExeFilename> -out:<manifestOutputFilename>
   ```
5. Edit the embedded manifest to add the new `<dpiAwareness>` tag (shown as follows).
   ```cpp theme={null}
   <windowsSettings>
       <dpiAwareness xmlns="https://schemas.microsoft.com/SMT/2016/WindowsSettings">
           PerMonitorV2
       </dpiAwareness>
   </windowsSettings>
   ```
6. Update the embedded manifest via the command line by using the following [Mt.exe](https://learn.microsoft.com/windows/win32/sbscs/mt-exe) tool from the Windows SDK.
   ```cpp theme={null}
   mt -updateresource:<titleExeFilename> -manifest <manifestFilename>
   ```

Your title now supports high DPI displays.

## Validating high DPI awareness

#### To confirm that your title supports high DPI displays

1. Using a PC with a high DPI display, such as Surface Studio 2, go to **Settings** > **Display** and set your scaling to **150 percent**.
2. Launch your title.
3. Examine the screens where a cursor is present, and confirm that the title displays as expected. For example, a full-screen title should take up the entire screen.
4. Move the cursor across the screen, and ensure that it can reach the entire surface area of the title window.
5. Hover over interactive UI elements (like buttons), and confirm that visual states and interaction work as expected. For example, a button should change visual states when the cursor is directly over it, not adjacent to it.

## Notes

* Disabling registry virtualization can be suggested as a solution to high DPI awareness issues, but we don't recommend it.
* Visual Studio has a DPI Awareness option in Configuration Properties, but this uses the older `<dpiAware>` tag, which doesn't work for MSIXVC-packaged titles.

## See also

[Setting the default DPI awareness for a process](https://learn.microsoft.com/previous-versions/windows/desktop/legacy/mt846517\(v=vs.85\))


## Related topics

- [XAG 101: Text display](/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md)
- [XBOX Requirement test cases for PC and mobile games](/publishing/certification/pc-policy-tests.md)
- [XR-003 Title Quality for Submission](/publishing/certification/xr/xr-003.md)
- [XDisplay](/reference/system/xdisplay/xdisplay_members.md)
- [Supporting Games-as-a-Service (GaaS)](/build/core-features/common/packaging/supporting-games-as-a-service.md)