Home / Troubleshooting / Troubleshooting guide
Matter

Matter device will not pair

The Matter setup code fails, the device is not discovered or pairing stops before completion.

Applies to
  • Matter devices
  • Apple Home
  • Google Home
  • Alexa
  • SmartThings
Last verified2026-10-10
Quick answerTroubleshooting · last verified 2026-10-10

The Matter setup code fails, the device is not discovered or pairing stops before completion. Most common cause to check first: Device is not in pairing mode

Applies toMatter devices, Apple Home, Google Home
CategoryMatter
Escalate whenFor Thread devices, verify that a compatible Thread border router is online and that IPv6 is enabled on the network.
Last verified2026-10-10
How to cite this pageIoT Atlas. "Matter device will not pair". https://hi-spark.net/troubleshooting/matter-device-will-not-pair.html Last verified 2026-10-10.

Likely causes

  • Device is not in pairing mode
  • Phone is on the wrong Wi-Fi or Thread network
  • Thread border router unavailable
  • Old controller firmware
  • Setup code already used or device still paired elsewhere

Quick checks

  • Confirm the device is Matter-certified
  • Check whether the device uses Wi-Fi or Thread
  • Update the controller and device firmware
  • Confirm Bluetooth is enabled during commissioning
  • Remove stale pairings from other ecosystems

Step-by-step fix

1

Reset the Matter device using the manufacturer procedure

2

Open the intended controller app

3

Scan the Matter QR code or enter the manual pairing code

4

Keep the phone near the device during commissioning

5

Complete naming and room assignment

6

Test local control before adding a second controller