Start by separating hardware from software.
A mapping problem occurs when the physical control you press does not match the action or label the software expects. It can come from a nonstandard browser layout, an incorrect controller mode, a translation layer, or a game's own configuration.
First determine whether the raw input itself is stable. Press one control at a time in the mapping tester and note its index. If the same physical button consistently activates the same raw index, the issue is usually translation or configuration rather than an intermittent switch.
Nintendo-style face-button letters deserve special care because their printed positions differ from the Xbox convention used by many PC interfaces.
Work through the likely causes.
- 01
Use the raw mapping test and record every physical control with its reported button or axis index.
- 02
Check whether the browser reports a standard mapping or an empty mapping value.
- 03
Confirm the controller is in the input mode recommended for your operating system and game.
- 04
Temporarily close Steam Input, remappers, and virtual-controller software to see the direct device mapping.
- 05
Restore only the translation layer you need, then configure the game or platform remap once instead of stacking remaps.
- 06
Save the final mapping and test it in the intended game before changing firmware or drivers.
Check what the browser can see.
Open the full tester to inspect buttons, sticks, triggers, mapping, range, and neutral noise.
Repeat before you conclude.
A repeatable issue across connections, browsers, and native games is stronger evidence of a controller fault than a one-time browser reading. If the problem appears only in one game, review that game’s controller support, deadzone, remapping, and launcher settings.
What to keep in mind
Avoid stacking multiple remappers; it makes diagnosis harder and can duplicate input.
How the browser readings are defined
Our live tools use the standardized browser Gamepad interface and explain its limits in our methodology. Device mappings and proprietary features can still differ by operating system, browser, connection, firmware, and controller mode.
Questions about this issue
Why are Nintendo A/B and X/Y shown differently?
Nintendo and Xbox place those letters in different physical positions. A position-based standard mapping may be functioning correctly even when the displayed letter differs from the controller shell.
Can this site permanently remap buttons?
No. It helps identify the mapping. Apply changes in the game, Steam Input, supported operating-system settings, or trusted manufacturer software.
Why do I get two button presses?
Both the physical controller and an emulated virtual controller may be active. Disable one translation path or configure the game to use only the intended device.