“It does not work” can describe at least three different failures: the camera cannot detect a code, the reader detects but cannot decode it, or the payload decodes but the intended destination fails. Separate those stages before changing the design.

The camera cannot find the symbol

Finder patterns need to be visible and the code needs a clear boundary. Decorative frames, cropped edges, busy photographs, very low contrast, and glare can prevent detection. Restore the quiet zone, remove nearby square graphics, and test with a plain high-contrast version.

Distance and focus also matter. A code can occupy too few camera pixels when far away or sit closer than the lens can focus when extremely near. Increase physical size or change the scanning position.

The symbol is found but not decoded

Dense payloads create small modules. Printing or image resampling may merge those modules. Logos and artwork may cover too much data, while folds, scratches, curvature, or perspective can remove more information than error correction can recover.

Return to a clean export. Shorten the payload, remove the logo, choose a suitable correction level, enlarge the code, and print without effects. Add changes one at a time so the cause remains visible.

The code decodes but the action fails

Copy the decoded text and inspect it before assuming the graphic is bad. A website may be offline, redirect through an expired service, reject mobile traffic, or use an unsafe or malformed URL. Wi-Fi credentials may contain an escaping mistake. A telephone or email action may be unsupported by the scanning device.

For a web destination, type the exact decoded URL into a private browser window and test on the target network. Avoid automatically opening unknown URLs during diagnosis.

A controlled troubleshooting sequence

  1. Scan the original exported file on a screen.
  2. Decode it with a second independent reader.
  3. Verify the recovered payload character by character.
  4. Test the final destination or device action.
  5. Scan the produced object under neutral light.
  6. Change one variable - size, contrast, logo, material, or payload - at a time.

This sequence distinguishes encoding from reproduction. If the source scans and the printed version does not, the problem is likely in sizing, layout, printing, material, or environment.

Original example: a glossy menu

A restaurant code scans from the designer’s laptop but fails on the laminated menu. The payload is correct. Under ceiling spotlights, a white reflection crosses two finder patterns. Moving the code does not fix the production issue; switching to a matte finish or relocating it away from direct glare does.

Create the code you need

Use HighEndDIY’s private browser tool, then test the result in the setting where people will scan it.

Create a QR Code

Found something that should be corrected? Email [email protected].