First identify which failure you have: the source image cannot be decoded, only the printed card fails, or the QR decodes successfully but opens or saves the wrong thing. Those paths have different fixes.
Reproducible three-path diagnosis#
- Save or export the exact QR image used in the card layout. Upload that PNG or SVG to the local image scanner. It reads the file in your browser; QRFlow does not claim that a phone or print was tested.
- If the source image does not decode, stop diagnosing paper. Regenerate a plain QR, keep the quiet zone, remove styling, and shorten or simplify the payload.
- If the source decodes, compare its decoded text with the intended URL or vCard. For example, a fictional card intended to save Ada Chen at ada@example.com is wrong if the decoded text contains an old email—even when the QR is visually perfect.
- If the text is correct but only the paper card fails, measure the complete QR including its quiet zone and inspect the final print for blur, low contrast, glare, cropping, ink spread, or damage.
- If the phone decodes the expected vCard but saves the wrong field or takes the wrong action, the print is not the problem. Rebuild a minimal contact in the business card QR generator, then add optional fields back one at a time and test with the intended contact app.
8 causes and the fix for each#
- Too small: use 20–25 mm for most cards; use 25–30 mm for a dense vCard or weaker print quality.
- Quiet zone cropped: keep a blank border of at least four QR modules on all sides.
- Low contrast: use a dark code on a light, solid background; avoid gradients and transparent overlays.
- Gloss or glare: move the QR away from spot UV, foil, holographic stock, folds, and curved surfaces.
- Blurred export: print from SVG when possible; do not enlarge a screenshot or compressed preview.
- Dense vCard: remove notes, extra URLs, secondary phone numbers, and other nonessential fields.
- Heavy styling: remove the logo or decorative modules, then retest the plain QR before adding styling back.
- Print damage: check for scratches, ink spread, trimming, a border touching the code, or a fold through the modules.
Test before ordering another batch#
QRFlow can help decode a source image and generate a replacement, but it cannot inspect your physical card or certify how every phone imports a contact. Record your own print and device results before approving the batch.
Use the right diagnostic tool#
Check the file with the QR scanner, confirm print dimensions with the QR size calculator, review the business card size guide, and verify the quiet zone rule. If the payload itself is too dense, rebuild a minimal vCard in the business card QR generator.
Quiet-zone reference: DENSO WAVE: determining the code area.
For failures that are not specific to business cards, use the full QR not-scanning checklist.