Skip to content

Gamepad Mapping Tester

See whether the browser assigns the standard mapping and how labels line up with indexes.

Start testing Read guide
Gamepad Mapping Tester

Mapping inspector

Standard mapping enables shared button labels; unknown means vendor layout.

Understand standard mapping versus mystery indexes

Gamepad Mapping Tester explains how the browser labels buttons when mapping is standard versus when it is an empty string. Standard mapping aims at a familiar Xbox-like layout. Unknown mapping means you should bind by index after empirical presses. Use this before assuming a DualSense Create button is broken when it simply sits on a different index than your mental model. Player overview: Controller Tester.

Adapters, fight sticks, and flight throttles frequently break assumptions. The Gamepad API will not invent console icons for every HID descriptor. Honest testing presses each control once and records the index that fired.

Mapping lab steps

  • Note the mapping string at connect time.
  • Press controls in a fixed order and log indexes.
  • Compare Xbox and PlayStation pads side by side.
  • Escalate odd axes to Analog Stick Test.

Developers may also keep Gamepad API Tester open. Detection failures still route to Controller Detection.

FAQ: should games ignore mapping and always use indexes?

Many do for robustness. Standard mapping helps defaults, but unknown devices need fallbacks. This tester shows why those fallbacks exist.