How to connect your controller and get testing

If step 3 didn't happen, don't worry, it's almost always something small. Keep reading.

This trips people up more than anything else. Browsers don't hand over gamepad data automatically the moment you plug something in. That's on purpose. Web pages could otherwise fingerprint your hardware or snoop on input without you knowing, so the Gamepad API stays silent until it sees a real physical interaction, a button press or a stick movement.

That means even if your controller is plugged in correctly, showing a solid light, and working fine in every other app on your computer, this site (and every other browser-based gamepad tester) will show nothing until you physically press something. It's not a bug, and it's not specific to this site. Once you know this, half the "my controller isn't detected" confusion disappears.

USB is the most reliable way to connect any controller, and for most people it's genuinely plug and play.

1. Plug the controller into any free USB port.
2. Give your operating system a couple of seconds to recognize the new device. Windows usually plays a little chime.
3. Open or refresh the home tester.
4. Press any button. A, X, Cross, or the Home/Guide button all work fine.

A few things that trip people up

Bluetooth needs one extra step compared to USB: pairing the controller with your computer through your system settings, before this page can see it.

On Windows 11

1. Put the controller into pairing mode. On an Xbox controller, hold the small Pair button on the top edge for about 3 seconds until the Xbox logo starts flashing quickly rather than staying solid.
2. Click Start, then go to Settings > Bluetooth & devices.
3. Turn the Bluetooth toggle on if it isn't already.
4. Click Add device, choose Bluetooth, and select your controller once it shows up in the list.
5. Wait for Windows to confirm the device is ready.
6. Come back to this tab and press a button to wake it up.

A few Windows-specific notes: DualShock 4 and DualSense controllers pair with Share + PS held together. Switch Pro controllers use the small sync button on the top edge, near the USB-C port. If a controller was previously paired with a console, it sometimes needs to be manually forgotten from that console first. Some controllers only remember one paired device at a time. Keep the controller within about 20 to 25 feet of your PC during pairing. Range drops fast through walls, and interference from other 2.4GHz devices can cause pairing to time out. If Windows shows the device but pairing keeps failing, remove it from Bluetooth & devices entirely and start fresh.

On macOS

1. Put the controller into pairing mode the same way as above.
2. Open System Settings > Bluetooth.
3. Wait for the controller to appear under Nearby Devices and click Connect.
4. Refresh this page and press any button.

Officially supported Bluetooth controllers on macOS are first-party Xbox, PS4, PS5, and MFi-certified pads. Third-party and generic Bluetooth controllers can be hit or miss depending on your macOS version. If yours won't pair at all, use a USB cable instead.

On Linux

1. Open your desktop's Bluetooth settings (varies by desktop environment, usually under Settings > Bluetooth).
2. Put the controller into pairing mode.
3. Select it from the discovered devices list and connect.
4. If it connects but doesn't work in the browser, check that the xpad or hid-sony kernel driver is loaded. Most distros include these by default.

On Android and iOS

Both handle Bluetooth gamepads natively, no extra app required for basic input.

• Android: go to Settings > Connected devices > Pair new device, then follow the same pairing-mode steps as above.
• iOS/iPadOS: needs version 16.4 or later for broad Bluetooth gamepad support. Go to Settings > Bluetooth and connect as usual. Earlier iOS versions only support a shorter list of MFi-certified controllers.

The Gamepad API is supported broadly, but the experience isn't identical everywhere.

If a specific feature isn't working, like vibration testing, before assuming your controller is broken, try the same test in Chrome or Edge. It rules out a browser limitation versus an actual hardware issue.

Both work fine for testing and for most games, but if you're chasing every millisecond for competitive play, here's the honest breakdown.

Wired (USB) gives the most consistent, lowest latency connection, and polling rates on wired controllers can reach 500 to 1000Hz depending on the pad. There's no battery to manage, and no chance of interference dropping your connection mid-match.

Bluetooth is more convenient day to day, but typically runs a lower polling rate, often 125 to 250Hz, and can occasionally suffer from interference in crowded wireless environments. For casual play it's rarely noticeable. For ranked or competitive play, wired is the safer bet.

You can measure the real difference on your own setup with our Polling Rate Test and Latency Test, comparing the same controller wired versus wireless.

A little maintenance goes a long way toward avoiding the problems this whole guide exists to solve.

• Store it somewhere dust-free. Dust inside the stick housing is the number one cause of stick drift over time. A drawer or a dedicated case beats leaving it sitting out.
• Don't let the battery sit fully drained for long periods. If your controller has a built-in rechargeable battery, deep discharges for extended stretches can shorten its lifespan. Topping it up every few months when not in regular use helps.
• Update the firmware occasionally. Manufacturers push out updates that improve deadzone handling, connection stability, and battery efficiency. Worth checking every so often through the official companion app (Xbox Accessories, DualSense companion app, etc).
• Avoid high-wattage fast chargers unless the manual says it's fine. Some controllers charge fine on a basic 5W brick but can have issues on aggressive fast-charging bricks meant for phones.

Work through these in order. Together they resolve nearly every connection issue we hear about.

With the status pill showing Live, you're ready for any test on the site. A few good starting points depending on why you're here:

• New controller, just unboxed? Start with Button Mapping Test to catch factory defects early, before a return window closes.
• Buying used? Run Button Mapping, then Stick Drift Test, then Vibration Test in that order.
• Something feels off in your aim? Go straight to Stick Drift Test.
• Setting up for competitive play? Compare wired versus wireless with Polling Rate Test and Latency Test.