Matter pairing can fail because of the controller, the network, the device state, or the commissioning code. Repeated resets rarely reveal which one is responsible.
Check the prerequisites
Confirm the accessory has the Matter logo and identify whether it uses Wi-Fi or Thread. A Thread accessory needs a suitable Thread network path for your platform. Update the controller and phone, then check the manufacturer's instructions for the exact pairing mode.
Use the original setup code from the device or its documentation. If it was already paired elsewhere, follow the maker's multi-admin or sharing procedure rather than assuming a fresh QR scan will work.
Check discovery
Put your phone on the intended home network, keep it near the device, and avoid guest-network isolation during setup unless your platform explicitly supports it. If other devices pair but this one does not, inspect this model's firmware and factory reset instructions.
For Home Assistant, verify that the Matter integration and server are running, then check the official network requirements. Matter relies on local discovery; unusual VLAN or multicast settings can matter.
Reset last
Record the error message, device LED state, and controller version before resetting. Reset only the failing accessory after exhausting prerequisites, then pair it to one controller first. This gives you a clean result to compare with the earlier attempt.
A quick checklist
- Identify Wi-Fi or Thread
- Update controller software
- Check original code and sharing state
- Record error before reset
Source & further reading
Technical requirements vary by model, ecosystem, and software version. Use the official documentation below alongside your device maker's current instructions.
Home Assistant: Matter integration