How to Add a Matter Device to Alexa, Google or Apple Home

Adding a Matter device works almost the same way no matter which app you use: you scan an 11-digit Matter setup code (usually a QR code on the device or its box), let the platform commission the device onto your network, then assign it to a room. The differences between Amazon Alexa, Google Home, and Apple Home are small but worth knowing — mainly which hub each one uses and whether the device needs Wi-Fi or Thread. This guide walks through all three, plus the fixes for when commissioning fails.

Before you start: what Matter actually needs

Matter is an interoperability standard from the Connectivity Standards Alliance (CSA). A device built to it can join any Matter-compatible platform — but the platform still needs the right pieces in place first. Two things trip people up most often.

First, the controller hub. To run Matter, each ecosystem expects a compatible hub device on your account: an Echo for Alexa, a Nest speaker or display (or compatible Google TV) for Google Home, and a HomePod or Apple TV for Apple Home. Without one, the app may still scan the code but can't keep the device connected.

Second, the transport. Matter devices run over either Wi-Fi (2.4 GHz) or Thread, a low-power mesh. Thread devices need a Thread border router — and not every hub includes one. If you're unsure which your device uses or what a border router does, see What Is a Thread Border Router (and Do You Need One)? and Matter vs Thread: What's the Difference?

Find your Matter setup code first

Every Matter device ships with a setup code — a QR code and the same value as an 11-digit number. It may be printed on the device, on a sticker on the back or base, in the manual, or on the box. A few devices show it on a built-in screen. Photograph it before mounting the device; people regularly stick a sensor to a wall, then realize the code is now facing the drywall.

Add the device in the Alexa app

1. Make sure you have a compatible Echo on your account acting as the hub, and that your phone is on the same Wi-Fi.
2. In the Alexa app, go to add a device and choose the option to set up a device with Matter (look for the Matter logo).
3. Scan the QR code, or enter the 11-digit code manually if the camera won't focus.
4. Wait while Alexa commissions the device — this can take a minute or two. Then assign it to a group/room.

Once it's added, you can fold the device into automations — see How to Create Alexa Routines (Step by Step).

Add the device in the Google Home app

1. Confirm a Nest hub or compatible device is on your account; keep your phone nearby with Bluetooth on.
2. In the Google Home app, tap to add a device and choose the Matter-enabled device path.
3. Scan the QR / setup code. Google often detects the Matter code automatically and offers a one-tap add.
4. Pick a home and room, name the device, and finish.

Add the device in the Apple Home app

1. Make sure a HomePod or Apple TV is set up as a home hub, and you're signed into the right Apple Account on the iPhone or iPad.
2. In the Home app, tap add accessory and point the camera at the Matter QR code.
3. If a security prompt asks whether to add an accessory from an uncertified source, that's normal for some devices — confirm to continue.
4. Assign a room and finish. The device appears alongside your HomeKit accessories.

1. 1Locate and photograph the Matter setup code
2. 2Confirm you have a compatible hub (Echo / Nest / HomePod)
3. 3Open the app and choose add a Matter device
4. 4Scan the QR or enter the 11-digit code
5. 5Assign a room and test the control

One device, three platforms: how multi-admin works

A real strength of Matter is multi-admin — the same device can belong to Alexa, Google Home, and Apple Home at the same time, so a light reachable from your Echo also responds to Siri. You commission it normally in the first app, then generate a new pairing code from inside that app to share it with the next platform.

Platform	Typical hub	Thread border router?	Share to add another platform
Amazon Alexa	Compatible Echo	Some models	Generate a new setup code in the Alexa app
Google Home	Nest speaker/display	Some models	Use the "share/link" Matter option in Google Home
Apple Home	HomePod / Apple TV	HomePod mini and newer; Apple TV 4K (some)	"Turn On Pairing Mode" in the accessory settings

When commissioning fails: a troubleshooting checklist

Most failed Matter setups come down to a few causes. Work through these in order:

• No compatible hub. The single most common reason. Confirm the right hub for that ecosystem is online and on the same account.
• Wrong Wi-Fi band. Wi-Fi Matter devices need 2.4 GHz. If your router uses one combined network name, the phone may have latched onto 5 GHz. General fixes for this live in Smart Device Won't Connect to Wi-Fi During Setup? 10 Fixes.
• Bluetooth off. The initial handshake usually rides over Bluetooth. Enable it and grant the app permission.
• Thread mesh not reachable. If it's a Thread device, make sure a border router is powered and within range.
• Device already commissioned elsewhere. A device tied to a previous account can't be freshly added. Factory-reset it (check the manual for the button sequence) and try again.
• Damaged or blurry code. Type the 11-digit number by hand instead of scanning.

Frequently asked questions

Do I need a hub for every Matter device?

For most setups, yes. A Wi-Fi Matter device can technically be controlled locally, but to use it through Alexa, Google Home, or Apple Home — and to reach it remotely — each platform expects a compatible controller hub on your account. Thread devices always need a border router.

Can the same device work with Alexa and Apple Home at once?

Yes. That's Matter's multi-admin feature. Commission it in one app, then generate a fresh pairing code from that app and add it to the second platform. Both keep working simultaneously.

Why won't my phone scan the Matter QR code?

Usually focus or lighting. Clean the camera, improve the light, and hold steady. If it still won't read, every Matter code has an 11-digit numeric equivalent you can type in manually within the app.

What's the difference between a Matter code and a HomeKit code?

Older HomeKit accessories used an 8-digit setup code that only worked with Apple Home. A Matter setup code is 11 digits and works across Alexa, Google, and Apple. Some newer Apple-compatible devices are Matter devices and use the 11-digit format.

Sources

• Connectivity Standards Alliance — Matter
• Thread Group — What is Thread (Overview)
• Google Nest Help Center
• Amazon Alexa