Guides

Can you pair a Matter device without the QR code?

Yes. Every Matter device also carries an eleven-digit pairing code you can type in. It works for almost all of them, with one exception worth knowing about.

By

2 min read

Yes. The Matter specification requires every device to carry an eleven-digit numeric pairing code alongside the QR code, precisely so you can pair without a camera. Type it in and it works.

Entering the code by hand

Start adding an accessory in your smart home app, whether that is Apple Home, Google Home or Alexa, and choose “enter code manually” or “I can’t scan” rather than the camera. Type the eleven digits, usually shown grouped as XXXX-XXX-XXXX. The device has to be powered on and in pairing mode, so reset it first if it has been used before.

What the QR carries that the number does not

The eleven-digit code is a trimmed-down version of what is in the QR. The QR holds a fuller device identifier, the vendor and product IDs, and a flag for which radios the accessory is listening on: Bluetooth, Wi-Fi or Thread. The manual code leaves most of that out.

In practice you will not notice. Pairing over the typed code still works. It can just take a little longer while your app works out how to reach the device, and the accessory needs to be actively advertising rather than sitting idle. A fresh reset sorts that.

The one case where the QR matters

Some Matter devices use a custom commissioning flow. The QR sets a flag that tells your app to visit a manufacturer step first, such as a firmware download or an account link, before pairing continues. For those the eleven-digit code on its own is not enough, and the setup instructions will point you at the QR or the maker’s app. This is rare, and the packaging usually makes it clear.

If you have no code at all

You cannot commission a Matter device without its pairing code. It is a required secret, used to prove your app and the device are in the same place.

There are two ways back. If the device has never been set up, recover the code from the box, the manual or the maker. If it is already paired to another platform, open it there and turn on pairing mode, which mints a fresh temporary code you can type into your other app.

Frequently asked questions

How do I enter a Matter code manually?
In your smart home app, start adding an accessory and choose the option to enter a code instead of scanning. Type the eleven-digit pairing code, usually grouped as four, three, four. The device has to be powered on and in pairing mode.
Does the eleven-digit code do everything the QR does?
Almost. The QR also carries a fuller device identifier and a hint about which radios the accessory uses, so manual pairing can be a little slower and needs the device actively advertising. The end result is the same.
When is the QR actually required?
For the small number of devices that use a custom commissioning flow. The QR flags this and sends your app to a manufacturer step first. Those devices tell you to scan the QR or use their own app.
The code is gone and the device is already on another platform.
Open it in that app and turn on pairing mode. It generates a fresh, temporary code you can type into your other app. You do not need the original.

Guides

Can you pair a HomeKit device without the QR code?

Yes. The QR code is just the eight-digit setup code in a scannable wrapper. If you have the number, you can type it in by hand. Here is how, and when it is your only option.

2 min read

  • homekit
  • setup-codes
  • pairing
  • qr-code
  • apple-home

Guides

Can you find your HomeKit setup code in the Apple Home app?

The Apple Home app never shows the setup code for an accessory you have already paired. Here is why, the one Matter exception that gets close, and where the real code lives.

3 min read

  • homekit
  • matter
  • apple-home
  • setup-codes
  • pairing

← All posts