Troubleshooting for failing to set up a Matter device

(1) Matter setup is active for 15 minutes from when the Matter device is powered up. If the Matter setup process is not completed in 15 minutes, a power cycle or factory reset will be needed.

(2) Make sure Bluetooth on your phone is enabled and re-enable Bluetooth.

(3) Make sure your Matter-enabled hub is online and you can control it normally through the APP.

(4) Make sure your phone and the Matter-enabled hub are connected to the same Home Wi-Fi to which you’d like your Matter device connected. (Your phone and Matter device are required to connect to 2.4GHz Wi-Fi)

(5) Make sure your phone’s camera is facing the QR code, not tilted and the code fits into the frame and is not too far from the edges of the frame before you scan the QR code for Matter setup.

(6) If you fail to set up your Matter device by scanning the QR code many times, please try to set up your device by entering the Numeric code.

(7) Please disable AP Isolation and enable the IPv6 function on your Router.

(8) Reset your Matter device, reboot your phone and Matter-enabled hub, and clear the cache of the Smart Home APP.

Special troubleshooting for failing to set up a Matter device in Apple Home:

(1) Upgrade to the new, more reliable, and more efficient home architecture.

Please upgrade the new Home architecture refer to the guidance from Apple.

(Click the link to get to the guidance: https://support.apple.com/en-us/HT213481)

(2) Please reboot your phone and then create a new home in Apple Home and reset your Matter device to pair it to the new home.

(3) If you’ve set up more than one Hub in one of your Homes, please check whether the hub which is listed as the first one in the Home is connected.

Step1. Tap the ‘…’ icon on the top right corner of the Home APP -> Tap Home Settings -> Home Hubs & Bridges.

Step2. If the Hub listed as the first one is not located in the Home actually, please delete the hub until one of the other Hubs of the Home comes to the first.

Step3. If the Hub listed as the first one in the Home is offline or abnormal, please reboot or reset the Hub to get it connected.

Note: if you fail to set up a HomeKit device to Apple Home APP, please refer to another FAQ: HomeKit setup troubleshooting | TP-Link

Special troubleshooting for failing to set up a Matter device in Alexa:

(Please ensure select the 2.4GHz Wi-Fi for your Matter device as soon as possible:

Step 1. Please kill the Alexa APP, then disable and enable Bluetooth on your phone to set up your Matter device again.

Step 2. When the Wi-Fi selecting page comes in Alexa APP, please select the SSID of your 2.4GHz Wi-Fi for your Matter device within 5 seconds.

Notes:

(1) If you fail to set up your connected Matter device with another smart home system, please refer to the FAQ: Troubleshooting for failing to set up a Matter device with another smart home system

(2) Some platforms or apps may automate the setup process further automatically detecting matter-enabled devices when they're plugged in and providing an audible or voice notification to guide you through the process.

(3) Some platforms support sharing the Matter-certified device with other accounts after it’s configured successfully. Device sharing to other accounts would not occupy the quota of ecosystem/fabric paired with a Matter-certified device.

Take Apple for an example: https://support.apple.com/en-us/HT208709