Matter device won’t pair: the fixes in order

Check the phone and the device first

1. Update your phone and the platform’s app to the latest version.

2. Turn on Bluetooth on the phone if your setup app asks for it. Many devices use Bluetooth LE to receive network details; devices already on the network can use IP instead.

3. Join the phone to your home Wi-Fi, not a guest network or mobile data.

4. For a Wi-Fi Matter device, put the phone on the 2.4 GHz network the device will use.

5. Power the device on and keep it close to the phone and your hub.

6. Put the device into pairing mode as its maker describes, just before you start.

Amazon’s developer guidance notes that pairing windows are short and often missed. If setup takes a while, put the device back into pairing mode and start again. Amazon asks you to keep the device within 9 metres (30 feet) of the Echo during setup; Apple suggests moving it closer to the router.

Use the right setup code

1. Scan the Matter QR code on the device, its box or the manual.

2. If scanning fails, type the numeric pairing code printed beside the QR code (11 or 21 digits).

3. In the Home Assistant app, tap More options… (iPhone) or Setup without QR-code (Android).

4. In Google Home, choose Add a different way if the QR code won’t scan.

5. If the device is already in another app, create a sharing code there and use that instead.

A device already set up in another app won’t accept its printed code as new. Apple’s Home app offers it under More options instead, and Alexa and Google Home both have a flow for devices from another system.

Consider a reset only after other checks

To share a device already in another Matter app, first use that app’s sharing flow. Apple says a reset may be needed for an accessory previously used in another home. A factory reset can remove its existing setup and require it to be added again.

1. Try the existing device’s sharing flow before removing or resetting it.

2. If the maker recommends a reset, save the original setup code and check the consequences first.

3. Follow the maker’s reset and pairing instructions, then add the device again.

For Thread devices, check the border router

Google Home and Home Assistant require a Thread border router for Thread devices. Apple also supports direct pairing with certain Thread-enabled iPhones. Apple shows “Thread Border Router Required” or “Needs Thread Network”; Google asks for a Thread border router.

1. Check that you have a border router: see the Thread page for each maker’s list.

2. Restart the border router, such as a HomePod mini, Nest Hub or Echo.

3. If an Apple TV is the border router and uses Ethernet, Apple suggests connecting it to Wi-Fi instead.

4. Check the border router is on the same Wi-Fi network as your phone.

5. Stand near both the border router and the device while you add it.

6. On Android, Google suggests clearing stored Thread credentials only after every other step fails.

Check the router settings Matter depends on

Home Assistant identifies local IPv6 and multicast DNS as network requirements to check when commissioning or discovery fails.

• IPv6: Google says IPv6 must be on for your home Wi-Fi, or setup may seem to work and control fail later. Your internet provider doesn’t need to offer IPv6.
• Multicast and mDNS: turn off router or access-point features that filter or “optimise” multicast. Home Assistant also warns about faulty IGMP snooping and mesh systems that filter mDNS.
• Same network or VLAN: keep your phone, the hub and Wi-Fi Matter devices on one network. Home Assistant asks for Wi-Fi devices and border routers on its own VLAN.
• Client isolation and guest networks: isolation can stop devices on the same Wi-Fi reaching each other and interfere with discovery.
• VPN and security apps: Apple asks you to check them for network problems.

Errors each platform documents

• Apple Home, “Unable to add to home”: power the accessory on, move it closer to the router, unplug and replug hubs and bridges, then reset the accessory.
• Apple Home, “network is incompatible”: join a 2.4 GHz network; some accessories don’t work on 5 GHz.
• Apple Home, “not supported”: update the accessory’s firmware in its maker’s app.
• Google Home, setup freezes: restart the device, clear the Google Home app’s cache, restart the phone and try again. Check that a Matter hub is set up in Google Home first.
• Alexa: for a Thread device, check that a Thread-enabled Echo or eero is online. Without one, Amazon suggests adding the device with another Thread-enabled assistant first, then sharing it to Alexa.
• Home Assistant: on Android, set the Companion app’s location permission to Allow all the time. Thread pairing needs a border router connected to the Home Assistant network.

Questions

Sources

• Apple Support: If you can’t add a smart home accessory to the Home app
• Apple Support: If you see a ‘Thread Border Router Required’ alert
• Google Home Help: Set up, manage and control Matter-enabled devices
• Google Home Developers: Matter troubleshooting
• Amazon Help: Connect Matter smart home devices to Alexa
• Amazon Alexa Developer Docs: Best practices to commission Matter devices
• Home Assistant: Matter integration
• OpenThread: mDNS discovery

Checked on 1 November 2026.

More device guides