Matter Device Won't Pair? 8 Fixes That Work
When a Matter device refuses to pair, the cause is almost always one of a handful of predictable issues: an unreadable or already-used pairing code, your phone sitting on the wrong Wi-Fi band, a missing Thread border router, or a device that was never fully factory-reset from a previous ecosystem. Matter's setup process (called commissioning) is strict by design — it needs Bluetooth, the right network, and a valid one-time credential all lined up at once. Work through the fixes below in order, because the early ones resolve the large majority of failures with the least effort.
Before you start: how Matter pairing actually works
Understanding the sequence tells you where things break. When you scan the code, your phone opens a short-range Bluetooth Low Energy link to the device, hands over your Wi-Fi or Thread network credentials, verifies the device's certificate against the Connectivity Standards Alliance's trust chain, then moves the device onto your main network. A failure at any stage looks the same to you — "couldn't connect" — but the underlying causes differ.
The 8 fixes, in order
- 1Confirm Bluetooth and location are on
- 2Put your phone on 2.4 GHz Wi-Fi
- 3Re-check the pairing code
- 4Factory reset the device
- 5Add a Thread border router
- 6Bring the device closer during setup
- 7Update the app, hub, and firmware
- 8Remove old commissionings first
1. Turn on Bluetooth and location permissions
Matter's first handshake is Bluetooth, not Wi-Fi. If Bluetooth is off, or the Alexa, Google Home, or Apple Home app hasn't been granted Bluetooth and local-network permissions, commissioning fails immediately. On iOS and Android, open your phone's settings and confirm the app has Bluetooth and local network (and, on Android, location) access — Android ties nearby-device scanning to location permission.
2. Get your phone onto 2.4 GHz Wi-Fi
Most Matter-over-Wi-Fi devices join a 2.4 GHz network only. If your phone is on a 5 GHz or 6 GHz band during setup — common with a single combined SSID — the app may fail to move the device onto a network it can actually reach. The reliable fix is to temporarily connect your phone to the 2.4 GHz band before pairing. If your router uses band steering with one network name, you generally don't need to split it permanently; joining 2.4 GHz just for commissioning is enough.
3. Re-check the pairing code
The 11-digit numeric code or QR code is a one-time credential for a single commissioning attempt. Two things trip people up: the code is misread (the printed digits are small, and a smudged QR fails to scan), or the code was already consumed by a previous, partially completed pairing. If the QR won't scan, use the manual numeric entry option in your app instead. If the code simply won't take, the device likely needs a reset — see the next step. For codes you can't locate at all, our guide on finding or resetting a lost Matter pairing code walks through where manufacturers print them.
4. Factory reset the device
A device that shipped pre-paired, was returned, or failed a prior setup can hold stale commissioning data that blocks a fresh attempt. A full factory reset clears it and re-enables the pairing window. Reset steps vary by manufacturer — usually a button hold or a power-cycle sequence — so check the product's own instructions. Our walkthrough on factory resetting a Matter device and re-pairing it covers the common patterns.
5. Make sure you have a working Thread border router
Thread-based Matter devices cannot pair without a border router — a device that bridges the Thread mesh to your Wi-Fi/Ethernet network. If you have no border router, the device has nowhere to join and setup stalls even when everything else is correct. Many people already own one inside a smart speaker or hub; see our roundup of Thread border routers you may already own. Ecosystem matters here too: an Apple-only border router won't help you commission into Google Home. Match the border router's platform to the app you're pairing with.
6. Move the device closer during setup
Because commissioning starts over short-range Bluetooth, distance and interference matter more during setup than in daily use. Bring the phone and the device within a few feet of each other, and keep both near your hub or router for the initial handshake. You can relocate the device afterward.
7. Update the app, hub firmware, and device firmware
Matter is young and evolving, and interoperability fixes ship constantly. An outdated controller app or hub firmware can reject an otherwise valid device. Update the Alexa, Google Home, Apple Home, or SmartThings app, confirm your hub or speaker has current firmware, and apply any device firmware update the manufacturer offers.
8. Remove old commissionings and multi-admin conflicts
A Matter device tracks a limited number of ecosystem "admins" (called fabrics). If a device is already fully commissioned elsewhere — or its fabric slots are full — a new controller may refuse to join. If you're intentionally sharing a device, you must generate a new sharing code from the first ecosystem rather than starting fresh. Our explainers on Matter multi-admin and sharing a device across Alexa, Google, and Apple Home cover the correct order.
Wi-Fi Matter vs. Thread Matter: what each needs to pair
Knowing which transport your device uses narrows the diagnosis quickly.
| Requirement | Matter over Wi-Fi | Matter over Thread |
|---|---|---|
| Radio for daily operation | 2.4 GHz Wi-Fi | Thread (802.15.4) |
| Bluetooth for setup | Yes | Yes |
| Border router needed | No | Yes |
| Common pairing blocker | Phone on 5/6 GHz band | No/incompatible border router |
Frequently asked questions
Why does my Matter device say "code already in use"?
The pairing code is a single-use credential tied to one commissioning attempt. If a previous attempt got partway through, the code is spent. Factory reset the device to reopen its pairing window and generate a fresh, valid code.
Do I need the internet to pair a Matter device?
Most controllers require internet during initial commissioning to verify the device's certificate, even though many Matter devices run locally afterward. If your network is offline, setup can fail at the verification step. See our piece on whether Matter devices need the internet.
My Thread device won't pair even after resetting it. Now what?
Confirm you actually have a compatible border router that matches the app you're using, and that its firmware is current. A weak Thread mesh can also stall setup — our guide on checking Thread network health helps you rule that out.
Is a Matter bridge the same as pairing a Matter device?
No. A bridge exposes non-Matter devices (like existing Zigbee gear) to Matter through a single connection. If you're pairing a bridge, you commission the bridge itself, not each downstream device. Our Matter bridge explainer covers when you need one.
