Where to Find Your Matter Pairing Code (QR Code)
Your Matter pairing code lives in more places than you might think. The primary spot is a printed QR code and an 11-digit numeric code (formatted like 1234-567-8901) on the device itself, but the same code is usually repeated on the box, in the printed quick-start leaflet, and sometimes inside the manufacturer's own app. So before you assume it's gone for good, check the device body, the packaging, and any paperwork you kept — the code is duplicated on purpose precisely because small stickers get lost.
Below we'll walk through every place the code hides, how to read it, and what your options are if the physical label is genuinely gone.
What a Matter pairing code actually is
Under the Connectivity Standards Alliance (CSA) Matter specification, every certified device ships with an onboarding payload. In plain terms, that's the setup credential your phone scans or types to bring the device onto your network securely. It shows up in two interchangeable forms:
- The QR code — a square barcode that encodes the pairing information plus a few extra bits (like which network technology the device uses). Scanning it is the fastest, most error-proof path.
- The 11-digit manual code — a numeric string, usually shown as
1234-567-8901, that you type in when a camera scan isn't practical. Both encode enough to onboard the same device.
You'll often see the QR code accompanied by a small "Matter" wordmark or the Matter logo, which is a quick way to distinguish it from an unrelated Wi-Fi or Bluetooth QR sticker.
1. Check the device itself first
The most reliable copy is on the hardware, because it's tied to that specific unit. Where to look depends on the form factor:
- Bulbs and plugs: On the base, the underside, or a wrap-around label near the prongs. On bulbs, the code is sometimes on the plastic collar between the glass and the screw base.
- Sensors and buttons: Behind the battery cover or on the back plate. You may need to pop the housing to see it.
- Thermostats, locks, and hubs: On the rear panel, inside a battery compartment, or under a removable faceplate.
- Cameras and larger devices: On the bottom or back, often near the model and serial numbers.
If the printed code is tiny or faded, good lighting and your phone's camera zoom help. Take a clear photo and store it somewhere safe — that habit alone prevents most "lost code" situations later.
2. Look on the box and the printed guide
Manufacturers almost always duplicate the pairing code on the retail packaging and in the quick-start leaflet. This is deliberate: the CSA and device makers know a sticker on a bulb base becomes unreadable once it's screwed into a fixture. Check:
- The outer box, usually on a side panel or the bottom flap, sometimes on a peel-off sticker.
- The quick-start card or fold-out sheet inside — the QR code is frequently printed right next to the setup steps.
- Any spare sticker sheet. Some brands include an extra adhesive label with the code so you can stick it inside a cabinet door or in a home binder.
If you've filed away boxes and manuals, this is the moment they pay off. The code on the box is identical to the one on the device.
3. Check the manufacturer's own app
This is the step people overlook. Many brands run their own app alongside Matter support, and some let you retrieve or regenerate the pairing code digitally so you can share the device to a new platform without hunting for the sticker.
Behavior varies by brand, so frame your search around the specific manufacturer's app rather than expecting a universal button:
- Open the brand's app and find the device's settings or details screen.
- Look for an option worded like “add to another platform,” “Matter,” “pair with other services,” or “share.” Selecting it often displays a fresh QR code on screen.
- That on-screen code is what you scan in the Alexa app, Google Home app, Apple Home, or SmartThings.
This path matters most for multi-admin setups, where you're adding an already-configured device to a second ecosystem. If that's your goal, our guide to Matter multi-admin and the walkthrough on how to share a Matter device across Alexa, Google & Apple Home cover the exact flow.
QR code vs. numeric code: which to use
Both do the same job, but they suit different situations. Here's how they compare:
| Situation | QR code | 11-digit numeric code |
|---|---|---|
| Speed | Fastest — scan and go | Slower — manual entry |
| Error risk | Very low | Higher (easy to mistype) |
| Damaged or partial label | Fails if the square is torn | Works if the digits are still legible |
| Sharing remotely | Send a photo of the square | Read the digits over a call |
Rule of thumb: scan the QR code when you can, and fall back to typing the 11 digits when the camera won't focus or the square is smudged.
If the code is genuinely gone
If the sticker is destroyed, the box is long gone, and the app offers no digital code, you're not stuck — but the fix is more involved. A factory reset clears the device's existing commissioning so you can re-pair it, and on many devices the reset itself doesn't require the original code. What you'll still need is a code to re-add it afterward, which is why checking every printed and digital source first is worth the effort.
We cover the full recovery path — including which brands can regenerate a code and which can't — in Lost Your Matter Pairing Code? How to Find or Reset It, and the reset mechanics in How to Factory Reset a Matter Device and Re-Pair It.
- 1Check the device body, base, or battery compartment
- 2Check the box and quick-start guide
- 3Open the manufacturer app and look for a share/Matter option
- 4Only if all fail, factory reset and re-pair
Frequently asked questions
Is the Matter pairing code the same as a Wi-Fi or Bluetooth code?
No. A Matter QR code is specifically the device's onboarding payload and usually carries the Matter logo or wordmark. A device may also have unrelated QR stickers (for a companion app download or a Wi-Fi setup), so match the one labeled for Matter or paired with the 11-digit numeric string.
Can I reuse the same code to add a device to a second platform?
Yes — that's Matter multi-admin. Once a device is on one ecosystem, you generate a new setup code (often from within the first platform's app or the manufacturer app) to add it to a second. You don't have to physically re-scan the original sticker each time.
What if my phone camera won't scan the QR code?
Clean the lens, improve the lighting, and hold steady at a slight distance so the whole square is in frame. If it still won't read — common with tiny or curved labels — switch to manual entry and type the 11-digit numeric code instead. Both onboard the same device.
Do I need the code every time the device drops offline?
No. The pairing code is only needed for initial commissioning (or re-commissioning after a reset). A device that's simply dropped off your network usually reconnects on its own or after a power cycle. If it keeps dropping, that's typically a network issue — see our guide on how to check your Thread network health and signal strength rather than re-pairing.
