Troubleshooting

Fix: My QR code is not scanning

Most scan failures are about contrast, size, or a stale link.

3 min readLast updated:
  1. 1

    Re-download a fresh QR

    Open Share → QR and download a new copy (older PNGs may point to a stale URL).

  2. 2

    Check size and contrast

    Print at least 1 inch wide, dark code on a light background.

  3. 3

    Avoid glossy surfaces

    Glare blocks scanners. Matte stickers, paper, or dark-mode screens scan better.

  4. 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.

Submit a request