Troubleshooting QR Code Scan Failures at Check-In

5 min readbeginner
Check-in AgentProgram Manager

Introduction

When a QR code won't scan or the scanner shows invalid ticket, duplicate scan, or already checked in, the cause is usually device glare, a screenshot instead of live My Tix, or a ticket that was already used. This guide helps check-in agents and Sub-Admins resolve scan failures quickly at the door.

Objectives

After reading this article, you will be able to:

  • Fix common QR won't scan problems
  • Handle duplicate scan and already checked in results
  • Escalate to manual check-in when needed

Prerequisites

Video tutorial

YouTube embed placeholder — replace with a published video ID in Stage 5.

Scanner error states for invalid and duplicate QR codes
Invalid QR, duplicate scan, and already checked in messages appear on the scanner after each attempt.

Steps

Step 1: Fix QR won't scan (device issues)

  1. Ask the attendee to open live My Tix — not a screenshot or email attachment unless organizer policy allows it.
  2. Increase screen brightness to maximum.
  3. Clean the phone screen and remove glare by tilting the device.
  4. Retry the scan from 6–12 inches away.

If the QR code still won't scan, proceed to manual check-in.

Step 2: Resolve invalid ticket errors

ErrorLikely causeFix
InvalidWrong event, cancelled, or refunded ticketConfirm event name in My Tix; check missing ticket
Not foundTicket on different accountAttendee signs in to purchase account
ExpiredEvent ended or ticket voidedContact Sub-Admin

Step 3: Handle duplicate scan / already checked in

  1. Read the scanner message — already checked in means this ticket was scanned earlier.
  2. Ask for photo ID if re-entry is disputed.
  3. Check the live attendance dashboard for the original check-in time.
  4. Deny re-entry per organizer policy if the guest already entered.

Step 4: Use manual check-in

When scanning cannot be resolved in under one minute:

  1. Open Manual check-in in the agent tool.
  2. Search by attendee name or email.
  3. Check in the guest manually after verifying identity.
  4. Note the reason for audit (for example, QR won't scan).

Step 5: Escalate to Sub-Admin

Contact the on-site Sub-Admin when:

  • Manual lookup returns attendee not found
  • Multiple guests report invalid tickets for the same event
  • Scanner hardware fails for all tickets

Troubleshooting

ProblemLikely causeSolution
QR won't scanScreenshot or low brightnessLive My Tix at full brightness
Invalid QRWrong or cancelled ticketVerify event and account
Duplicate scanRe-entry attemptCheck ID; deny per policy
All scans failWrong event selectedAgent reopens correct event

Frequently Asked Questions

Can attendees use printed QR codes?

Organizer policy varies. Live My Tix is preferred because cancelled tickets update in the app.

Why does a valid ticket show already checked in?

Someone already scanned that ticket. Each QR admits one entry unless the organizer issues a replacement.

Where does Sub-Admin see scan errors?

On the live attendance dashboard and in the post-event check-in log.

Next steps

Return to scan tickets at the door after resolving the issue.

Release notes

_No release note links yet._

Next step

Next: How to Scan Tickets at the Door (Check-In Agent Guide)