What is a Matter pairing code?

Every Matter smart home device comes with a setup code that lets a phone app or a hub add it to your home. It's printed twice: as a QR code, whose text starts with MT:, and as a manual pairing code of 11 or 21 digits that you type in when the camera can't read the QR code. Both carry the setup passcode, a secret the app proves it knows when it connects, and the discriminator, a number that tells the device apart from others waiting nearby.

How to use it

Type or paste the text of the QR code or the manual pairing code. Spaces, dashes and lower case letters are fine, and the code is decoded as you type. To read a code from a photo of a label, use the Matter Pairing Code Reader.

What you see

  • Code type: QR code text, or a manual pairing code of 11 or 21 digits.
  • Vendor ID and Product ID, in decimal and in hex. Vendor IDs 0xFFF1 to 0xFFF4 are test vendor IDs, used by development kits and the Matter SDK's examples. An 11-digit code doesn't carry either ID.
  • Discriminator: the full 12-bit value from a QR code. A manual code carries only its upper 4 bits.
  • Setup passcode, written as the eight digits the Matter specification uses.
  • Commissioning flow: Standard (the device is ready to pair as soon as it's powered on), User action required (press a button or follow the manual first) or Custom (the steps are in the manufacturer's entry in the Distributed Compliance Ledger, the Matter certification database). An 11-digit code always means the standard flow.
  • Manual pairing code: the digits printed next to the QR code, worked out from the QR code text. A device with the standard flow prints 11 digits; other flows need the 21-digit code with the vendor and product IDs.
  • Discovery methods: how the device can be found while it waits to be set up: Bluetooth LE, already on the IP network, Wi-Fi Public Action Frame, NFC, Thread, or Wi-Fi Soft-AP on older devices. Only QR codes list them.
  • Extra data: a serial number, a commissioning timeout and other optional fields that some QR codes carry.

A QR code can hold the codes of several devices sold together; pick one in the Device list.

When a code isn't valid

The last digit of a manual pairing code is a Verhoeff check digit, which catches any single mistyped digit and any two swapped neighbors, so a typo shows up at once. The tool also tells you when the passcode is one of the trivial ones the specification forbids, like eight identical digits, when the vendor ID is outside the range the specification allows, and when the code uses a format version that isn't defined.

Privacy

Decoding runs in your browser, so the code isn't sent anywhere. A setup code lets anyone nearby add the device while it's waiting to be set up, so don't share a real one in screenshots or posts.