Matter QR Code or Setup Code Rejected During Commissioning
- Camera cannot read the QR code clearly due to lighting, distance, or print quality
- Device was previously commissioned and must be factory reset before the code is valid again
- The 11-digit code was entered with a transcription error
Problem Description
When trying to add a Matter device, the controller app rejects the QR code scan or the manually entered 11-digit setup code with an error such as Invalid code, QR code not recognized, or Setup code already used. The device is in commissioning mode and the LED is blinking, but the app cannot validate the code. Matter setup codes encode cryptographic device identity — code rejection means either the code cannot be read accurately, the device is no longer in a fresh commissioning state, or the code has been used and not cleared.
Symptoms
- App shows Invalid setup code or QR code not recognized after scanning
- Manual 11-digit code entry is rejected as invalid
- QR code scans and appears to load but then shows an error immediately
- Setup code works in one controller app but is rejected in another
- Device was previously commissioned and the original QR code is now rejected
Recognize these? Here's what usually causes it.
Common Causes
- Camera cannot read the QR code clearly due to lighting, distance, or print quality
- Device was previously commissioned and must be factory reset before the code is valid again
- The 11-digit code was entered with a transcription error
- Device is not actually in commissioning mode despite LED indication
- Code belongs to a different device or a device on a different account
Most fixes happen in the first 3 steps.
Each factory reset gives the same QR code a fresh commissioning window. The QR code itself does not change — it is the device state that determines whether the code is valid.
Tools & Requirements
These tools will help you complete this fix.
Drill optional
DEWALT 20V MAX Cordless Drill and Impact Driver, Pow...
Level
9 Inch Torpedo Level Magnetic, Shock-Proof Small Lev...
Screwdriver
STREBITO 155 in 1 Electric Screwdriver Set, Small El...
As an Amazon Associate we earn from qualifying purchases.
Step-by-Step Solution
Verify code source and device commissioning state
Confirm you are scanning the correct Matter code for the exact device and that it is in fresh pairing mode, because stale or wrong codes are rejected immediately.
Clear previous failed commissioning attempts
Remove partial entries from the controller app and reset the device, because retained failed fabric state can cause every subsequent code attempt to fail.
Check phone camera quality and manual code fallback
Use clear lighting for QR scan and switch to manual numeric code if scan fails, since camera distortion or print wear can corrupt code reads.
Validate controller, hub, and firmware compatibility
Ensure controller app, OS, and Matter services are updated, because outdated commissioning stacks commonly reject valid setup credentials.
Retry with one controller only and confirm success
Perform commissioning from a single primary ecosystem first, then add sharing fabrics later, so initial setup complexity does not mask root errors.
Quick Solutions
Still having issues? This is usually the deeper cause below.
If the keypad rejects valid codes, a lockout timer may be running — five failed entries locks most keypads silently for 5–10 minutes.
Matter setup codes can also be found in the manufacturer's app under device information after the device is added via the native app. This is useful if the physical label is worn or missing.
This issue almost always looks more complex than it is — the majority of cases trace back to a single setting, a stale credential, or a default that shipped wrong.
- Camera cannot read the QR code clearly
- Device was previously commissioned and must be factory reset
- The 11-digit code was entered with a transcription error
- Device is not actually in commissioning mode despite LED
- Code belongs to a different device or a device
Before you go — try one of these (they fix most cases).
Official Manufacturer Manual
Matter provides official product documentation through their online manual rather than downloadable PDF. Access setup guides, troubleshooting steps, and product specifications for your Matter Device.
Source: csa-iot.org
