Matter Pairing Code Generator
Make the QR code and the manual pairing codes of a Matter device from its vendor ID, product ID, discriminator and setup passcode. Download the QR code as PNG, JPG, WebP or SVG.
Input
Output
Readme
What it makes
The setup code of a Matter smart home device: the QR code, whose text starts with MT:, and the manual pairing codes of 11 and 21 digits that you type in when a camera can't read the QR code. They're the codes a manufacturer prints on a device's label, made from its onboarding data. It's handy when you build a Matter device, for example on a development board, and need a label for it, or when you know a device's setup data and want a fresh label.
How to use it
- Vendor ID and Product ID: type them as decimal numbers or as hex starting with
0x. Vendor IDs 0xFFF1 to 0xFFF4 are for testing; certified products have a vendor ID from the Connectivity Standards Alliance. Enter 0 for both to leave them out of the QR code. - Discriminator: a number from 0 to 4095 that apps use to find the device among others nearby. The dice button picks a random one.
- Setup passcode: up to eight digits. The specification forbids trivial ones, like eight identical digits, 12345678 and 87654321. The dice button picks a random passcode the specification allows.
- Commissioning flow: Standard when the device is ready to pair as soon as it's powered on, User action required when the user must press a button or follow the manual first, Custom when the steps are in the manufacturer's entry in the Distributed Compliance Ledger.
- 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 or NFC.
The QR code's look (error correction, size, quiet zone and colors) can be changed below the device settings.
What you get
- The QR code, to download as PNG, JPG, WebP or SVG, with its text under Raw value.
- The 11-digit manual code, grouped the way devices print it. It exists only for the standard flow.
- The 21-digit manual code, which adds the vendor and product IDs. The user action required and custom flows need it, so they need both IDs.
A code works only when it matches the device: an app looks for a device with this discriminator and then has to prove the passcode the device stores. A made-up code doesn't pair with anything.
Privacy
The codes are made in your browser, so nothing you enter is sent anywhere. A real device's setup code lets anyone nearby add it while it's waiting to be set up, so keep those to yourself.