By Claire WhitakerAdding a Matter device to your smart home gives you a simple way to connect lights, locks, sensors, thermostats, and other gadgets across different platforms. The process relies on a Matter controller – such as a recent smart speaker, display, or hub – and a setup code that you scan or enter. This guide walks you through the requirements, the step-by-step setup, common mistakes, and how to fix them.
What You Need
Before you start, gather the following items and confirm a few technical details. The requirements differ slightly depending on whether your device uses Wi-Fi, Thread, or Ethernet for its main connection.
A Matter Controller
A Matter controller is the device that manages your Matter gadgets and allows you to control them from your phone, voice assistant, or automation rules. Many recent smart speakers, smart displays, and smart home hubs can act as Matter controllers. Check the product’s packaging or the manufacturer’s website to confirm that your hub or speaker supports Matter as a controller. Some older hubs may receive a firmware update that adds Matter support, so keep the device’s software up to date.
You can learn more about which brands and hubs support Matter by reading our Matter Compatibility guide.
A Thread Border Router (for Matter‑over‑Thread Devices)
If your Matter device uses Thread – a low‑power wireless protocol – you need a Thread border router in your home. The border router connects the Thread network to your Wi‑Fi or Ethernet network so that your phone and other devices can reach the Thread-based device. Many recent smart speakers, smart displays, and some Wi‑Fi routers include a Thread border router built in. Again, check the product’s specifications or the manufacturer’s list of compatible border routers. Without one, a Matter-over-Thread device cannot connect to your Matter setup.
Setup Codes (QR Code or Numeric Code)
Every Matter device comes with a unique setup code. This code is typically printed on the device itself, on a card inside the box, or on the packaging. The code can be a QR code, or a numeric pairing code (often 11 digits). Keep this code private – do not post photos of it online or share it with people you do not trust. The code is the only way to securely add the device to your smart home, and sharing it could let someone else control your devices. Because the physical code can rub off or get lost over time, take a clear photo of the QR code and the numeric code and store it in a secure place (such as a password‑protected photo album) before you peel off any sticker.
The Correct Smart Home App
You typically add a Matter device using the app of the controller that you want to use. For example, if your primary smart home app is from the maker of your hub, open that app and look for a “Add Matter device” or “Add accessories” option. Some controllers also allow you to add Matter devices directly from your phone’s settings (on Android or iOS). Make sure the app is updated to the latest version, as older versions may not support Matter setup.
Step‑by‑Step Instructions
Once you have everything ready, follow these general steps. The exact menu names may vary slightly by app, but the overall process is standardized across Matter devices.
1. Open Your Smart Home App and Choose “Add Device”
Launch your primary smart home app. Look for a plus icon or an “Add device” button. If the app supports Matter, it will offer an option labeled “Matter” or “Add Matter accessory”. Select that.
2. Scan or Enter the Setup Code
The app will ask for the setup code. Hold your phone’s camera over the QR code on the device or its included card. The app should automatically read the code. If the QR code is damaged or you prefer manual entry, tap the option to enter the numeric code (usually 11 digits). Type the code carefully; it must match exactly.
If you have a photo of the code saved, some apps let you upload the image or scan it from the photo library. However, scanning the code from the physical device is most reliable because it avoids any blur from the photo.
3. Confirm the Device (Bluetooth or Other Proximity Pairing)
Many Matter devices use Bluetooth during the initial setup to hand over Wi‑Fi network information or Thread credentials. Keep your phone close to the device – within a few feet – until the setup finishes. The app will show a progress indicator. If the device has a physical button or indicator light, you may need to press it or follow a prompt in the app. The exact behavior depends on the device type, so refer to the manufacturer’s instructions when you see on‑screen cues.
4. Wait for the Device to Join Your Wi‑Fi or Thread Network
After the Bluetooth handoff, the device connects to your home network. This can take anywhere from ten seconds to two minutes. Do not close the app or turn off your phone during this step. If the process seems stuck, wait at least two minutes before trying again.
5. Name Your Device and Set Its Room
Once the device appears in the app, give it a recognizable name (for example, “Living Room Light” or “Front Door Sensor”). Assign it to a room in your smart home. This makes voice commands and automation rules easier to manage.
6. (Optional) Share the Device to a Second Platform Using Multi‑Admin
Matter’s multi‑admin feature lets you control the same device from multiple smart home apps. After the device is added to your primary app, open the second app (for a different ecosystem) and choose “Add Matter device”. The second app will ask for a new setup code. In your primary app, look for a “Sharing” or “Pairing code” option for that specific device. Generate a new QR code or numeric code and use it in the second app. Each time you share, a fresh code is created; the original printed code is used for the first setup, and again after a factory reset.
For a deeper look at how different platforms work together, see our Compatibility & Protocols page.
Common Mistakes
Even with a straightforward setup process, a few issues happen frequently. Knowing them in advance can save you time.
Phone on a Different Wi‑Fi Band or Network
Your phone must be connected to the same 2.4 GHz or 5 GHz Wi‑Fi network that you want the device to use. If your phone is on a guest network or a separate Wi‑Fi band, the device may not receive the correct credentials. Check your phone’s Wi‑Fi settings and confirm it is on your home network (not a hotspot or a neighboring network). Some routers combine both bands under one name; that is fine as long as your phone is not on a separate VLAN or subnet.
Device Already Paired with Another Controller
Matter devices can be connected to only one controller at a time unless you use multi‑admin. If the device was previously set up with a different hub or app, it may still be “claimed.” In that case, you need to factory reset it (see the troubleshooting section below) before you can add it to a new controller.
Outdated Firmware or App
Both the Matter controller and your phone app must be running relatively recent versions. Check for firmware updates in the controller’s own settings, and update the app from your phone’s app store. If the app or firmware is more than a few months old, it may lack the latest Matter features or security fixes, which can prevent pairing.
Incorrect or Unreadable Setup Code
A smudged or scratched QR code may not scan. Clean the sticker or card gently with a dry cloth. If it is still unreadable, use the numeric code printed next to it. If that code is also missing, contact the device manufacturer for a replacement code (you may need to provide proof of purchase). Never try to guess a numeric code – that will not work and could lock the device’s pairing mode.
Troubleshooting
If the setup fails despite following the steps above, try the following solutions in order.
Restart the Controller and Phone
A quick restart of your smart home hub and your phone clears many temporary glitches. Unplug the hub for about 30 seconds, then plug it back in. Turn your phone off and on again. Then attempt the setup again.
Factory Reset the Device
If the device was previously connected to a different network or controller, you may need to reset it fully. Factory reset methods vary by device type. Common methods include:
- Pressing and holding a physical reset button for 5–10 seconds until an LED flashes or changes color.
- Unplugging the device and plugging it in while holding a button or switch (check the device’s manual).
- Using a specific sequence of power cycles (for example, on/off/on again).
After the reset, the device enters pairing mode again. Then you can scan the original setup code to add it like new. If you cannot find the reset procedure, refer to the printed manual or the manufacturer’s support page.
Check for Wi‑Fi Interference or Congestion
If your home has many Wi‑Fi devices, try bringing your phone and the new device close to your router. Temporarily turn off other non‑essential smart home devices to reduce network load. If you have a dual‑band router, confirm that your phone is on the same band as the device’s intended band – most Matter devices work on 2.4 GHz. For Thread devices, ensure your phone and the Thread border router are within range.
Update Firmware via a Wired Connection (if Applicable)
Some hubs allow you to connect an Ethernet cable directly. If your phone has trouble communicating with the hub wirelessly, try connecting the hub via Ethernet temporarily. Then go through the Matter setup again. This can bypass intermittent Wi‑Fi issues.
FAQ
Can I add a Matter device without a QR code?
Yes, if the numeric code is printed on the device or included in the packaging. Enter the numeric code into the app manually. If you have lost both the QR code and the numeric code, you will need to contact the device maker for a replacement code – but they may require proof of purchase and some devices cannot generate a substitute code.
What is the difference between Matter‑over‑Wi‑Fi and Matter‑over‑Thread?
Matter‑over‑Wi‑Fi uses your existing Wi‑Fi network, so the device connects directly to your router. Matter‑over‑Thread uses a low‑power mesh network that requires a Thread border router to bridge to your home network. Thread devices often have longer battery life and work better in large homes, but they need the border router. Both use the same Matter setup code and app.
How many platforms can I control a Matter device from?
With multi‑admin support, you can control a single Matter device from several different smart home apps – for example, your hub’s app and a separate voice assistant app. There is no hard limit, but each platform you add must be compatible with Matter and the device’s specific functions. Check the device’s specifications to confirm which features are available across platforms.
Is it safe to share my setup code with a friend?
Only with people you fully trust. The setup code grants control over the device, so share it only – typically family members who will use the device. If you need to let a guest control the device temporarily, use the guest access features in your smart home app instead of giving them the setup code. Never post a photo of the QR code publicly.
Adding a Matter device is designed to be simple, but the process relies on having the right controller and a valid setup code. By following the steps above and avoiding common pitfalls, you can quickly expand your smart home with a device that works across multiple platforms. For more details on how Matter interacts with existing smart home technologies, see our Wi‑Fi Smart Home Guide and Bluetooth Smart Home Guide.
About Claire Whitaker
Claire Whitaker is part of our editorial team and reviews and edits our smart home guides, checking product details against manufacturer specifications and owner feedback.
