Matter QR Code Generator
Smart home pairing codes for Matter devices
Generate Matter setup QR codes from valid Matter pairing information. Validate setup fields, understand manual setup code fallbacks, and prepare labels for Apple Home, Google Home, and Alexa setup flows.
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.
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 • Setup PIN pattern warning
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.
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.