Add a Matter-over-Thread accessory to Apple Home
Separate Matter pairing from Thread networking, then confirm whether the Apple Home setup has the border router and software the accessory needs.
Direct answer
The shortest reliable path.
Update the iPhone or iPad, add the accessory by scanning its Matter code in the Home app, and treat a “Thread Border Router Required” alert as a network-role problem—not a bad QR code. For remote control, notifications, and automations with Thread accessories, Apple says to use a Thread-enabled home hub or a compatible third-party Thread border router.
System view
Check the whole path.
- 01Matter setup code
- 02iPhone or iPad
- 03Apple Home
- 04Thread border router when required
- 05Accessory
Scope before steps.
Matter accessories being added to Apple Home from a supported iPhone or iPad, including accessories that communicate over Thread.
HomeKit-only accessories, manufacturer-specific account migration, Wi-Fi provisioning faults, or a promise that every Matter device type is supported by Apple Home.
Procedure
Do this in order.
- 01
Confirm Apple Home supports the accessory type
Check Apple’s current list of Matter accessory categories before troubleshooting the radio or resetting the product.
- 02
Add the accessory from Home
In the Home app, choose Add Accessory and scan the Matter code. If the accessory was paired to another compatible app, use More Options and select the existing accessory when it appears.
- 03
Resolve the Thread role explicitly
If Apple reports that a Thread border router or Thread network is required, confirm a supported Thread-enabled home hub or compatible third-party border router is online.
- 04
Verify local and remote control separately
Test control while at home, then test notifications, automations, or remote access only after the home hub and Thread network are healthy.
Diagnostic matrix
Read the result, not the guess.
| What you see | Check next | What it means |
|---|---|---|
| The Matter code scans but setup stops with a Thread alert | Verify the exact Apple device acting as the Thread-enabled home hub or border router. | The pairing payload was read; the missing dependency is the Thread network role. |
| The accessory already belongs to another ecosystem | Use that manufacturer or ecosystem’s sharing flow to obtain a fresh Matter pairing code. | The original onboarding state may no longer be the correct path for multi-admin sharing. |
| Local control works but remote control does not | Check the home hub and Thread border router before resetting the accessory. | The accessory is paired; the wider home path is incomplete or offline. |
Stop conditions
Know when not to keep changing things.
- Do not repeatedly remove the accessory from every ecosystem while the border-router requirement is unresolved.
- Do not claim that an iPhone alone supplies every remote-control or automation role; follow Apple’s current device requirements.
- Contact the accessory manufacturer when the product cannot enter pairing mode or its setup code is rejected as invalid.