Troubleshooting
Fix: My QR code is not scanning
Most scan failures are about contrast, size, or a stale link.
3 min readLast updated:
- 1
Re-download a fresh QR
Open Share → QR and download a new copy (older PNGs may point to a stale URL).
- 2
Check size and contrast
Print at least 1 inch wide, dark code on a light background.
- 3
Avoid glossy surfaces
Glare blocks scanners. Matte stickers, paper, or dark-mode screens scan better.
- 4
Confirm your card is published
An unpublished card returns a 404 even if the QR scans correctly.
Related guides
Still need help?
Submit a request and our OneTap team will get back to you.