Matter device won’t pair: step-by-step fixes

First, know which kind of device you have

Matter pairing has two paths. A Wi-Fi device receives your Wi-Fi name and password from your phone over Bluetooth, then joins your router. A Thread device receives the Thread network credentials and joins through a border router. The two fail for different reasons, so check the box or the app for the transport before troubleshooting. For background, see What is Matter?

Quick checklist

1. Power and pairing mode. Confirm the device is powered, and that it is in pairing mode. Many devices stay in pairing mode only for a limited time; if the app waited too long, repower or reset it per the manual.
2. Distance. Stand within a few feet of the device. Home Assistant’s documentation advises keeping the phone close to the border router and the device when a pairing stalls at checking network connectivity.
3. Bluetooth and permissions. Turn Bluetooth on and allow the app Bluetooth and local network access. On Android, Home Assistant’s documentation notes the companion app needs location access, and recommends Android 12 or higher; its minimum is 8.1.
4. Update the phone and apps. Apple’s support article says Matter accessories can be added without a home hub with iOS 18 or later. Home Assistant also notes that on Android a message that Matter is unavailable can mean the required Google Play Services Matter components are still downloading; it suggests waiting up to 24 hours and updating apps.
5. Scan the right code. Use the code on the device or box for a new device, or a fresh sharing code if it already belongs to another app.
6. Try typing the numeric code if the QR code will not scan. Glare and small print are common causes.

Fixes for Wi-Fi devices

• Use the 2.4 GHz band. Many Wi-Fi smart devices join only 2.4 GHz networks. Home Assistant’s documentation says to put the phone on the same 2.4 GHz Wi-Fi network for Wi-Fi devices. If your router merges 2.4 and 5 GHz under one name, pair while standing near the router, or temporarily turn off the 5 GHz band.
• Use the main network, not a guest network. Guest networks often isolate clients from each other, so the phone cannot see the device. A separate smart-home network needs deliberate setup; see how to separate smart devices safely.
• Turn off VPNs and any private DNS or content filter on the phone while pairing.
• Check for weak signal. If the device is at the edge of Wi-Fi coverage, move it closer to the router for pairing, then to its final spot. For persistent dropouts see why smart devices go offline.
• Check the Wi-Fi password. A typo is a frequent cause; some devices do not accept special characters.

Fixes for Thread devices

• Confirm a border router. If pairing says the device requires a border router, you need one that is powered and on your network. See Thread border router explained.
• Match the ecosystem. Home Assistant’s documentation notes that vendors usually form their own Thread networks and that credentials are not shared automatically. A phone may use a different network than the one you expect. Home Assistant says you may need to sync Thread credentials to your phone.
• Stay near the border router during pairing, then move the device.
• Power more devices. A mesh with only one border router and distant battery sensors has weak links. Mains-powered Thread devices strengthen it.

Router and network settings that break discovery

Matter relies on local IPv6 and multicast discovery messages. Home Assistant’s documentation lists VLANs, multicast filtering and IGMP snooping as causes of failed discovery, and advises a simple, flat network where Wi-Fi Matter devices and Thread border routers share a VLAN with the controller.

Already paired somewhere else?

A device that still holds an old pairing may refuse a new one, or the app may report it as in use. Check the old app and remove the device there, or use the sharing option instead; see Matter multi-admin. Home Assistant also has a choice for a device that is already in use by another controller.

Last resorts

1. Factory reset the device using the manufacturer’s sequence (often holding a button, or toggling power several times). Wait for the indicator that shows pairing mode.
2. Restart the phone, the router and the border router, in that order.
3. Try another phone or another ecosystem app to find out whether the problem is the device or your setup.
4. Check device support. A Matter device type may not be supported yet by your controller. Google, for instance, supports only the 31 device types in its list.
5. Update the device firmware through the maker’s app and contact support if it still fails.

If the fault is not Matter-specific, see smart device won’t connect to Wi-Fi.