Why Won't My Matter Device Pair? 8 Fixes That Work
If your Matter device won't pair, the cause is almost always in the first 60 seconds of commissioning — not the device itself. Matter uses a standard setup handshake, so a failed pairing usually points to one of a handful of things: a phone that isn't on the same 2.4 GHz network the device needs, a setup code that won't scan, a device that's already committed to another platform, or (for Thread devices) a missing border router. Work through the eight fixes below in order and most pairings that stall will complete.
How Matter pairing actually works (and why it fails)
Understanding the handshake makes every fix below make sense. When you add a Matter device, your phone acts as the commissioner. It reads the 11-digit setup code (from the QR code or the manual pairing code), reaches the device over Bluetooth LE, and uses that temporary Bluetooth link to hand the device your Wi-Fi or Thread credentials. Once the device joins the network, Bluetooth drops and it communicates over Wi-Fi or Thread from then on.
Because so many pieces have to line up at once — Bluetooth, the setup code, a 2.4 GHz network, and location permissions on your phone — a failure at any one of them looks the same to you: a spinning "connecting" screen that eventually times out. The fixes below isolate each link in that chain.
1. Put your phone on the 2.4 GHz network — and keep Bluetooth on
This is the single most common cause. Matter over Wi-Fi devices connect on the 2.4 GHz band only. During commissioning, your phone typically needs to be on that same 2.4 GHz network so it can pass credentials the device can actually use. On many modern routers, 2.4 and 5 GHz share one network name (SSID), and your phone may be sitting on 5 GHz.
- Confirm Bluetooth is turned on and that the controller app has Bluetooth and local network / nearby-devices permission in your phone's settings.
- If your router has a combined SSID, this usually works — but if pairing fails, temporarily separating the bands (or briefly disabling 5 GHz) forces your phone onto 2.4 GHz. Our guide to Wi-Fi bands and a stable network covers how to do this cleanly.
2. Factory-reset a device that was ever added somewhere else
A Matter device can only be commissioned to one fabric at a time before you deliberately share it. If the unit was ever added to another app, another account, or even briefly during a store demo, it will refuse a fresh pairing until it's reset. This trips up open-box and returned units constantly.
Check the manufacturer's instructions for the exact reset — it's often a button hold (typically 5–15 seconds) or a power-cycle sequence. After resetting, generate a fresh pairing attempt from the app rather than reusing a session that already timed out.
3. Get the setup code to read cleanly
The QR code carries the same data as the numeric code, but scanning fails for mundane reasons: glare, a code printed too small, or one hidden on the device body under a bracket. Every Matter device also ships with an 11-digit manual pairing code you can type in instead.
- If the camera won't lock on, look for the app's "enter code manually" option and type the 11-digit number.
- Find the code before you start — it may be on the device, the box, or a separate card. If it's genuinely lost, some manufacturers can reissue it; the device is otherwise very hard to commission without it.
- Clean the lens and add even, indirect light. Glare from a lamp or window is the usual culprit for a code that "won't scan."
4. For Thread devices, confirm you have a border router
Not all Matter devices use Wi-Fi. Many battery-powered sensors, locks, and shades use Thread, a low-power mesh. A Thread device cannot join your network unless a Thread border router is already present — that's the bridge between Thread and your Wi-Fi/internet.
You may already own one without realizing it. Border routers are built into devices like recent Apple HomePod and Apple TV models, several Google Nest and Amazon Echo models, and some SmartThings and Aqara hubs. If none of those are on your network, a Thread Matter device has nothing to join and pairing will stall. Our overview of whether you still need a smart-home hub explains which devices double as border routers.
5. Move the phone and device close together
The commissioning link runs over Bluetooth LE, which is short-range and easily blocked. Bring your phone within a few feet of the device — same room, no walls between them. For an in-wall or ceiling device you can't move, pair it before final installation if the manufacturer allows, or temporarily bring the controller (like an Echo or Nest speaker) closer.
6. Restart the pieces in the right order
A stale Bluetooth stack or a controller that's lost track of its own network state will fail silently. A clean restart clears both.
- 1Power-cycle the Matter device (unplug or pull the battery for 30 seconds)
- 2Toggle your phone’s Bluetooth and Wi-Fi off and back on, then reopen the app
- 3If a hub or speaker is the controller, restart it too, then retry the pairing from scratch
If your controller hub itself keeps dropping, that instability will sabotage pairing — see how to stabilize a hub that keeps disconnecting.
7. Rule out a weak or overloaded 2.4 GHz network
Even with the right band, a congested or weak 2.4 GHz signal can cause the credential handoff to fail right at the finish line. Interference from neighboring networks, a crowded channel, or being far from the router all reduce the odds of a successful join.
- Pair near the router first; you can relocate the device afterward.
- If your 2.4 GHz band is crowded, our guides to improving Wi-Fi for smart-home devices and diagnosing 2.4 GHz interference walk through channel and placement fixes.
8. Try a different controller — or check for a firmware update
Matter is designed to be cross-platform, but individual apps and device firmware still have rough edges. If one ecosystem refuses to commission a device, another sometimes succeeds.
| Controller | Where you add a device | Good to know |
|---|---|---|
| Apple Home | Home app, "Add Accessory" | HomePod / Apple TV can act as a Thread border router |
| Google Home | In the Google Home app | Several Nest devices are Thread border routers |
| Amazon Alexa | In the Alexa app | Several newer Echo models are Thread border routers |
| Samsung SmartThings | In the SmartThings app | SmartThings hubs can bridge Matter and Thread |
Also update the device's firmware if the manufacturer's app offers it, and make sure your controller app is on its latest version. Early Matter firmware shipped with commissioning bugs that later updates fixed.
Frequently asked questions
Does my Matter device need a hub to pair?
It depends on the radio. A Matter-over-Wi-Fi device pairs directly and needs no hub. A Matter-over-Thread device needs a Thread border router on your network to join — that's built into many popular speakers and streaming boxes, so you may already have one.
Why does pairing get to 90% and then fail?
That pattern usually means the Bluetooth handshake succeeded but the device couldn't join Wi-Fi or Thread — a wrong band, a weak 2.4 GHz signal, or a missing border router. Pair close to the router and confirm your phone is on 2.4 GHz.
Can the same device be in Apple Home and Google Home at once?
Yes, via Matter's multi-admin sharing. Commission it to one platform first, then use that app's "share" or "link to another app" option to generate a new pairing code for the second. Trying to commission the same device fresh in two apps will fail.
I lost the QR code. Can I still pair?
Only if you have the 11-digit manual pairing code, which appears alongside the QR code on the device, box, or an insert. Without either code the device is very difficult to commission; contact the manufacturer, who can sometimes reissue it.
