How to Add a Matter Device to Apple Home (When It Won't Pair)

By Matthew Easterday · Published Aug 6, 2026

Ten of the accessories in this house are Matter devices. Most paired the way the box promises: open the Home app, scan a QR code, confirm, done. Two stalled, for reasons common enough to write down as a fix order instead of one-off stories.

Before you start: hub connected, Bluetooth on, phone on the right Wi-Fi

Apple Home needs a home hub before it can add most Matter accessories, an Apple TV 4K or HomePod, not an iPad (what counts as a hub now). Check it before touching the accessory box: Home app, Home Settings, Home Hubs & Bridges, and confirm at least one hub reads Connected.

If the accessory uses Thread rather than Wi-Fi (most battery sensors and buttons do), the hub also needs a Thread border router running, and not every Apple TV 4K has the radio for it. Setting one up correctly covers which models qualify; a HomePod (2nd generation) or HomePod mini already set up as a hub is always a Thread border router too; the original 2018 HomePod has no Thread radio. If you’re not sure which transport a given accessory even uses, Matter over Wi-Fi vs Matter over Thread covers how to tell from the box before you buy.

Bluetooth also needs to be on. Apple Home’s initial pairing handshake with a new accessory runs over Bluetooth before the device ever touches Wi-Fi or Thread, so a phone with Bluetooth off won’t find anything to pair with in the first place. Keep the phone on the same Wi-Fi network, and the same band, as the home hub too. None of this throws a clear error message; a mismatch here just leaves the pairing screen stuck on “Searching” with nothing pointing at the actual cause.

The scan-and-confirm path: what the QR code does

The Home app’s own Add Accessory screen (reached from the plus icon in the top corner) opens its own camera view, separate from the iPhone’s regular Camera app, and scans the code printed on the device, its box, or an included manual. Point it at the code and Apple Home reads it directly, without routing through anything else on the phone.

What the code encodes, and how Apple Home uses it to find and authenticate the accessory, is Matter protocol territory covered separately in what Matter actually is. For pairing, the code is the fastest way to get the accessory’s identity and passcode into the Home app without typing either by hand.

That passcode isn’t one-time. It stays valid for as long as the device does, so keep the QR code photo or the printed number somewhere you can find it later. Deleting it after setup doesn’t add any security.

The 11-digit fallback: when the Camera app won’t read a Matter code

The iPhone’s standalone Camera app opens a HomeKit pairing code automatically, the same way it opens a Wi-Fi network’s QR code. It doesn’t do the same for a Matter code. Point the plain Camera app at one and nothing happens. That’s exactly what happened trying to add IKEA’s MYGGBETT door sensor : the QR code on the packaging sat there doing nothing until the Camera app was abandoned for the Home app’s Add Accessory flow, where typing the code finished the job.

Skip the Camera app entirely and go through the Home app instead. From Add Accessory, tap More Options rather than waiting on the automatic scan; with the sensor’s battery in and its indicator light blinking, it usually shows up on its own in a short list of nearby devices. Select it, and the same screen offers either a scanner for its code or a keypad for typing the 11-digit number by hand. Typing is the direct route once you know where the number lives: on MYGGBETT it’s printed on the side of the sensor itself, with a second QR copy hidden under a peel-off adhesive panel on the back that’s easy to miss.

Multi-fabric pairing: adding one device to more than one ecosystem

A single Matter accessory can be paired into more than one smart home platform at once, independently, through what Matter calls multi-admin. Add it to Apple Home first, the normal way. Later, open Google Home, Amazon Alexa, or another Matter controller and add the same accessory there as a separate action, usually by scanning the same QR code again or generating a new pairing code from the app that already controls it. Each platform keeps its own independent pairing record for the device, called a fabric, without needing to know about any other platform’s pairing. What fabrics and Matter certification mean in more depth is covered separately; the useful part here is that adding to a second ecosystem is always its own distinct step.

This house’s own Matter network shows exactly that in practice: the same physical devices, paired separately into more than one ecosystem, each with its own fabric ID (the full scan breakdown).

The fix order when setup stalls or fails

When pairing stalls partway through, or fails outright with an error, work through a fixed order rather than repeating the same scan five times in a row.

1. Confirm the home hub reads Connected.
2. Confirm a Thread border router is running, if the accessory needs one.
3. Confirm the phone and hub share a Wi-Fi network and band, with Bluetooth on.
4. Try the manual 11-digit code instead of the QR scan, even if the QR scan is what stalled.
5. Factory-reset the accessory and start over, only after all of the above.

Checking hub status, Thread coverage, and network settings first catches most failures, because a device that can’t reach a border router or find the hub over Bluetooth stalls the same way regardless of anything else. The fourth step is what rescued this pairing. IKEA’s GRILLPLATS smart plug stalled or failed outright four separate times before the setup code printed on a sticker in the included booklet, identical to the code printed on the plug itself, finally went through. A factory reset throws away anything the accessory has already learned about the network, so it’s the last step, done only after the checks above.

When it’s not your setup: manufacturer-side pairing bugs

Sometimes the fix order above runs the whole way through and the accessory still won’t pair. The cause isn’t always the hub or the network. Manufacturers ship pairing bugs of their own. IKEA’s 2026 Matter-over-Thread line has an acknowledged pairing-failure issue this cycle, with a firmware fix in progress; the reported failure rates and IKEA’s own statement are covered in a dedicated piece rather than repeated here.

This IKEA fleet, paired the same way described throughout this guide, hasn’t run into that particular bug. That’s one household’s experience. It doesn’t establish how common the bug is, or whether a newly bought unit will avoid it.

Checking whether a manufacturer has already acknowledged an issue, or shipped a firmware update addressing it, is a reasonable step before another factory reset, particularly for a device line currently making news for exactly this.

What to check if it pairs but drops offline later

A device that pairs cleanly and then disappears from Apple Home days or weeks later is a different problem from anything above, with its own set of causes: a border router that changed, a Wi-Fi network that changed, Thread mesh health, or a crash on the accessory’s own side. The dedicated guide for devices going offline after pairing covers that fix sequence in full.

Matthew Easterday

Runs the homekit.reviews test home, a real mixed Matter/Thread/HomeKit house. Everything reviewed here was set up, paired, and lived with. See how I test →