Fix: Game Runs at the Wrong Resolution or With Black Bars on Steam Deck

Black bars at the top and bottom of the Deck's screen, a blurry upscaled image, or a game window that does not fill the screen are some of the most common Deck complaints, and they cost points in Valve's Deck Verified review. They come down to aspect ratio and how the game chooses its resolution.

Why it happens

Most PC games assume 16:9 monitors. The Deck is 1280×800, 16:10. A game that starts at 1280×720 shows bars top and bottom; one that forces 1920×1080 is downscaled with bars; one that picks from a list of “standard” resolutions may not list 1280×800 at all. In Gaming Mode, Steam's compositor (gamescope) scales whatever the game outputs to the screen, so a wrong choice is visible rather than fatal.

Fix 1: default to the native resolution

On first launch, use the current display resolution rather than a hardcoded value:

• Unity: Screen.SetResolution(Screen.currentResolution.width, Screen.currentResolution.height, FullScreenMode.FullScreenWindow);
• Godot: use fullscreen window mode and read DisplayServer.screen_get_size(); set Display > Window > Stretch > Aspect to expand so 16:10 shows more of the scene instead of bars.
• Unreal: UGameUserSettings::GetDesktopResolution() with windowed fullscreen, applied when no saved settings exist.

Saved settings from a desktop session can follow a player to the Deck through Steam Cloud. If you sync a settings file, store resolution per device, or validate it against the current display on startup.

Fix 2: make the UI work at 16:10

Rendering at 1280×800 fixes the bars, but HUDs designed for 16:9 can then stretch, overlap or leave elements floating. Anchor HUD elements to screen edges rather than fixed positions, test at 1280×800, and keep text readable at that size; the post on Deck UI being too small covers sizing.

Fix 3: detect the Deck when you need to

For Deck-specific defaults (resolution, graphics preset, text scale), check ISteamUtils::IsSteamRunningOnSteamDeck() through your Steam wrapper, or the SteamDeck=1 environment variable Steam sets on the device. Use it for defaults only; players can dock the Deck to a 4K TV, at which point the display, not the device, should decide.

Steam’s own resolution setting

On the Deck, the game's Properties > General > Game Resolution controls what resolution Steam offers the game (Default, Native and specific values). If a player reports bars only on their Deck, ask what that setting is; if the game offers native resolution and still shows bars, it is your default (Fix 1).

Deck Verified

Valve's review checks that the game's default configuration supports the Deck's resolution (1280×800, or 1280×720 with bars), that text is legible and that the default graphics settings perform well. Fixing resolution defaults is one of the cheaper ways to move from Playable to Verified.

Deck reports with screenshots

Layout problems are hard to understand from text. Bugnet's SDKs for Unity, Godot and Unreal attach a screenshot, the resolution and the OS to every report a player files in-game, so a Deck layout bug arrives with a picture of the Deck's screen.

Related problems

• How to Fix Game UI Being Too Small to Read on Steam Deck
• Steam Deck Verification: How to Get the Green Check
• How to Fix a Game Not Launching on Steam Deck
• How to Fix the Steam Deck On-Screen Keyboard Not Opening for Text Fields

Frequently asked questions

What resolution should my game use on Steam Deck?

1280×800, the Deck’s native 16:10 resolution. Default to the display’s current resolution so docked Decks use the external screen’s resolution instead.

Why does my game have black bars on Steam Deck?

It renders at a 16:9 resolution such as 1280×720 or 1920×1080 on the Deck’s 16:10 screen. Render at the native resolution and make the UI work at 16:10.

How do I detect Steam Deck in my game?

Call ISteamUtils::IsSteamRunningOnSteamDeck through your Steam wrapper, or check the SteamDeck environment variable, which is set to 1 on the device.

Ask the display what it is. Never hardcode 1920×1080 as a default again.