Matter QR Code
Generator & Decoder
Generate a setup QR from your device’s pairing fields, or inspect an existing MT: payload. Both tools run locally in your browser.
The default fields are public test values. For an actual accessory, enter the setup PIN, discriminator, VID, and PID provisioned on that device; generating a different code does not change its pairing credentials.
Device Information
8 digits, avoid sequential or repeated numbers
0-4095 (12 bits)
Optional local check
This compares the VID only with a small built-in list of known test IDs. It does not query the CSA registry or verify a production VID/PID assignment.
QR Code Preview
QR preview
Generated code appears here.
Matter QR Code Decoder
Paste the MT: text read from an existing Matter QR code to inspect its setup PIN, discriminator, vendor ID, product ID, and commissioning fields. Decoding runs in your browser.
This tool reads a single QR text payload. It does not scan images, decode numeric manual setup codes, recover a missing device PIN, or confirm that an accessory will pair. To create a QR for a real device, use the setup fields already provisioned on that device.
A Matter QR code is the camera-scannable setup label used to start commissioning for a compatible smart home accessory. It carries the setup payload needed by the controller app before the device joins the home.
During setup, the app reads the QR code, extracts setup PIN and discriminator data, discovers the device through the advertised capability, and starts commissioning. Invalid VID, PID, setup PIN, or discriminator data can stop that flow before pairing completes.
The QR code is faster for camera setup and printed labels. The manual setup code is a fallback for users who cannot scan the QR or need to type a code from documentation.
A decoder turns the QR payload back into commissioning fields so a controller can begin setup. It can reveal whether fields are structurally readable, but it cannot confirm device ownership, radio availability, ecosystem support, or successful commissioning.
What this generator checks
Field ranges and payload structure • Local known test-VID warning • Disallowed Matter passcodes
Setup handoff checks
Validate fields before printing labels • Test with Apple Home, Google Home, Alexa, or SmartThings
Using Matter QR codes with smart home apps
Matter setup is standardized, but each ecosystem still has app-specific support, controller versions, and commissioning steps to verify.
Use the Matter QR code in the Apple Home add accessory flow. If setup fails, verify the setup PIN, discriminator, ecosystem support, and whether the device is in commissioning mode.
Google Home can use Matter setup QR codes for supported devices. Keep the printed QR clean and test with the final label size before packaging or enclosure production.
Alexa setup depends on Matter support for the device and controller environment. Use the validation report to catch setup-field errors before handing labels to installers or customers.
SmartThings can commission supported Matter accessories when the app, hub or controller, device type, and network meet the required compatibility. Validate the payload and test the exact accessory flow before printing labels in volume.
What is a Matter QR code?
A Matter QR code encodes setup information used during smart home device commissioning, including setup PIN, discriminator, vendor ID, product ID, commissioning flow, and discovery capability data.
Can I generate a Matter QR code online?
Yes. This page generates Matter setup QR data in the browser and validates common setup fields before you use the QR code for onboarding.
What fields are required for Matter device setup QR codes?
Typical Matter setup QR codes require setup PIN, discriminator, vendor ID, product ID, commissioning flow, and discovery capabilities.
What is the difference between a Matter QR code and a manual setup code?
The QR code packages setup data for camera scanning. The manual setup code is a numeric fallback users can type when a QR label is missing, damaged, or hard to scan.
Do Matter QR codes work with Apple Home, Google Home, Alexa, and SmartThings?
Matter QR codes are designed for compatible pairing flows across these ecosystems, but success still depends on the accessory, controller app, ecosystem version, network, and valid commissioning data.
What does a Matter QR decoder read?
A Matter QR decoder reads the standardized setup payload, such as the version, setup PIN, discriminator, vendor ID, product ID, commissioning flow, and discovery capabilities. Decoding a payload does not prove the accessory can be commissioned.
How do I decode a Matter QR code online?
Paste the complete MT: text payload into the Matter QR Code Decoder on this page and select Decode Matter QR code. The required setup fields are read locally in your browser. This tool does not scan QR images or decode numeric manual setup codes.
Can I recreate a lost Matter QR code from a made-up PIN?
No. A setup QR must match the PIN and commissioning fields provisioned on the accessory. Arbitrary values and the public test defaults do not unlock or pair a real device. Use the original label, device documentation, or manufacturer recovery process.
Should I print a Matter QR code?
Printed Matter QR labels can work well when the setup data is valid and the physical QR keeps enough size, clear border, contrast, and scan reliability.
If the Matter QR code will be printed on a label, enclosure, packaging insert, or 3D printed part, validate the physical QR print checks too.