Matter Device Stuck on 'Connecting'? How to Fix It
When a Matter device hangs on "Connecting", it has almost always been discovered by your phone but has not finished commissioning — the multi-step handshake where the controller verifies the device's certificate, hands it Wi-Fi or Thread credentials, and enrolls it in your fabric. The spinner means one of those steps stalled, not that the device is broken. The fastest reliable fix is to power-cycle the device, confirm your phone and hub are on the same 2.4 GHz network with Bluetooth on, and restart pairing from a fresh factory-reset state. Below, we work through the causes in the order they most often occur.
Why Matter devices get stuck on 'Connecting'
Commissioning uses Bluetooth Low Energy (BLE) for the initial connection, then moves the device onto its operational network — either Wi-Fi or, for Thread devices, a Thread mesh reached through a border router. The "Connecting" screen typically stalls at one of three handoffs:
- BLE discovery — your phone can't hold a stable Bluetooth link long enough to pass credentials.
- Network join — the device gets the credentials but can't actually reach your Wi-Fi (wrong band) or Thread network (no border router in range).
- Fabric enrollment — the device joins the network but the controller can't confirm it, often because the device was already commissioned elsewhere.
Knowing which handoff failed tells you which fix to try. The steps below are ordered from most common and least disruptive to most involved.
Step-by-step fixes, in order
- 1Power-cycle the device and phone, then retry
- 2Confirm 2.4 GHz Wi-Fi and enabled Bluetooth
- 3Factory-reset the device to clear a partial commission
- 4For Thread devices, check the border router
- 5Re-scan the Matter code from a fresh state
1. Power-cycle the device and your phone
A stalled commission often just needs a clean restart. Unplug the device (or pull its battery) for 30 seconds, and toggle your phone's Bluetooth and Wi-Fi off and back on. This clears a half-open BLE session that the app may be waiting on indefinitely. Retry pairing before doing anything more drastic — this resolves a large share of one-off stalls.
2. Get everything onto 2.4 GHz Wi-Fi
Most Matter-over-Wi-Fi devices are 2.4 GHz-only, and many stall precisely because the phone doing the commissioning is on 5 GHz or 6 GHz. If your router uses a single merged SSID with band steering, your phone may sit on 5 GHz while the device can only see 2.4 GHz. During pairing, connect your phone to the 2.4 GHz band — either by joining a separate 2.4 GHz SSID or temporarily pausing band steering. Our guide on smart-home Wi-Fi bands and SSIDs explains how to set this up cleanly.
3. Factory-reset the device to clear a partial commission
If the first attempt failed partway, the device may believe it's already half-committed to a fabric, which blocks a fresh attempt. A factory reset wipes that state. The reset procedure varies by device — a smart plug might use a 10-second button hold, a bulb a power-cycle sequence — so check the manufacturer's setup card or support page for the exact steps. After resetting, generate a fresh pairing session rather than reusing the old one.
4. For Thread devices, check the border router
Thread devices need a Thread border router — built into hubs like an Apple TV, HomePod, newer Echo devices, or Google/Nest hubs — within radio range to join the mesh. If the border router is offline, too far away, or on a different platform than the app you're pairing with, the device connects over BLE but can't complete its Thread join, and you're left on "Connecting." Confirm your hub is powered, updated, and reasonably close during setup. If you have several Thread border routers from different brands, keep one nearby and awake so the device has a clear path in.
5. Re-scan the code and watch for other controllers
Restart pairing from the app and rescan the Matter QR or 11-digit numeric code. If scanning itself is the problem, our guide on fixing Matter pairing codes covers lighting and code-entry fallbacks. Also make sure no other phone or hub in the house is trying to commission the same device at once — two controllers racing for the same device can leave both stuck.
Where the stall happens vs. what to try
| Symptom | Likely stage | First thing to try |
|---|---|---|
| Spinner right after scanning the code | BLE discovery | Toggle phone Bluetooth; move phone next to device |
| "Connecting" after code accepted, Wi-Fi device | Wi-Fi join | Put phone on 2.4 GHz; check Wi-Fi password |
| "Connecting" on a Thread device (sensor, lock) | Thread join | Confirm a powered border router is nearby |
| Fails near the end, every time | Fabric enrollment | Factory-reset the device, then retry |
Network conditions that quietly cause stalls
Even with the right steps, an unstable network can keep commissioning from finishing:
- Weak or congested 2.4 GHz — thick walls or a crowded channel can drop the join. See improving Wi-Fi for smart-home devices.
- Client isolation / AP isolation — some routers and guest networks block device-to-device traffic, which Matter needs. Disable it or avoid the guest SSID.
- An overloaded hub — if the hub acting as border router keeps dropping, that ripples into pairing. Our piece on a hub that keeps disconnecting can help.
If pairing never even reaches "Connecting," the issue is earlier — see why won't my Matter device pair for discovery-stage fixes.
Frequently asked questions
How long should Matter commissioning take before I call it stuck?
A normal commission usually completes in under a minute or two. If the spinner runs past roughly three to five minutes with no progress, treat it as stuck and restart from step 1. Waiting longer rarely helps once the handoff has stalled.
Does Bluetooth need to stay on the whole time?
Yes. Matter uses Bluetooth LE to carry credentials to the device during setup. If you turn Bluetooth off after scanning the code, the handoff can't finish and the app hangs on "Connecting." Leave it on until setup confirms success.
Why does it work in one app but not another?
Whichever controller you pair with must have a compatible network path — for Thread devices, that means a border router tied to that ecosystem. If the Apple Home app has a nearby Thread border router but the Google Home or Alexa app doesn't, pairing may only succeed in one. Pair with the app whose hub is present and healthy.
Will a factory reset lose my other settings?
Resetting only affects the single device — it clears that device's network and fabric data so it can be commissioned cleanly. It does not touch your other Matter devices, your hub, or your router. It's the safest reliable way to escape a half-finished commission.
