Q R Scanner

QR Scanner for Event Check-In

Use the QR scanner to check in guests and volunteers at your events and activities. This screen handles high-volume scanning with real-time validation, offline support, and automatic syncing to your event records.

Prerequisites

You need an active event with at least one activity configured. Your event organizer or system admin will provide you with a camera-enabled device and the scanner QR codes.

Starting a Scan Session

How to get there: Event Dashboard > Activities > Select an activity > Open Scanner

1. Tap the activity you want to scan for.
2. Grant camera permission when prompted (required to use the scanner).
3. Wait for the scanner to initialize — you’ll see a loading screen briefly.
4. The scanner is ready when you see the purple-tinted camera feed with a scan window in the center.

Camera Setup

Hold the device 15–30 cm from the QR code. Make sure the code is well-lit and fully inside the purple frame for fastest detection. A QR code typically scans in under 1 second.

Scanning a Single Ticket

How to get there: Scanner screen (already open)

1. Point your camera at the attendee’s QR code (printed on their ticket or shown on their phone).
2. Keep the code inside the purple scan frame until the scanner beeps.
3. Green frame + success sound = ticket is valid and checked in.
4. Red frame + error sound = ticket is invalid, expired, or already scanned.
5. The scanner automatically resets after 2 seconds and is ready for the next guest.

Multi-Entry Tickets

If a ticket covers multiple people (e.g., a family pass), after the first scan you’ll see a number selector with circles for 1–10 entries. Tap the number that matches how many people are entering. The scanner will confirm each person individually without needing to scan again.

Checking Multiple Entries from One Ticket

How to get there: Scanner screen after scanning a multi-entry ticket

1. After a valid multi-entry ticket scans, the Select Entries panel appears below the scanner.
2. The panel shows your available entries and how many you’ve already used.
3. Tap any number circle (1–10) to confirm that many people entering.
4. The scanner resets and is ready for the next guest.
5. If more entries are available, the panel updates to show the remaining numbers.
6. Tap X (clear button) if you need to cancel and rescan.

Entry Limit

The system shows which numbers you can tap based on the ticket’s remaining capacity. Grayed-out numbers mean you’ve used all entries for that batch.

Using the Flash Light

How to get there: Scanner screen

1. Tap the Flash icon (lightning bolt) in the top-right toolbar.
2. The device’s flash turns on (icon shows filled lightning).
3. Use the flash when scanning in low-light or outdoor evening venues.
4. Tap again to turn off the flash.

Next Best Action

Once you’ve scanned 10–20 guests, check the Sync button in the top toolbar to ensure all scans are uploaded to your dashboard.

Checking Ticket Details

How to get there: Scanner screen > Tap the Help icon (question mark)

1. Tap the Help icon in the top-right corner.
2. A Ticket Enquiry screen opens showing all registered attendees for your event.
3. Search by name, ticket ID, or phone number to verify guest information before or after scanning.
4. Tap Back to return to the scanner.

Use Case

Use this if a guest claims they registered but their ticket didn’t scan. You can confirm they’re in the system and troubleshoot the ticket code.

Syncing Scans to Your Dashboard

How to get there: Scanner screen

1. Look for the Sync button in the top toolbar (next to the connection indicator).
2. If syncing automatically, you’ll see “Syncing…” and a spinner.
3. Tap Sync to manually force an upload of all pending scans.
4. Once complete, a green confirmation message appears briefly.
5. Your dashboard updates with the latest check-in counts.

Offline Scanning

The scanner works offline — all scans are stored locally and automatically synced when you reconnect to WiFi or mobile data. You don’t need to do anything; syncing happens in the background.

Toggling Feedback (Sound & Color)

How to get there: Scanner screen

1. Tap the Color Feedback icon (palette) to toggle the green/red frame animations.
2. Tap the Sound Feedback icon (speaker) to toggle the beep sounds.
3. Disable both in quiet venues (libraries, hospitals, silent auctions) or enable both in loud outdoor events.

Accessibility

Turning off color feedback doesn’t stop validation — the scan still works; you just won’t see the frame change color. Sound is independent, so you can have one without the other.

Viewing Scanner Logs (Troubleshooting)

How to get there: Scanner screen > Tap the Debug Info icon (bug icon in orange)

1. Tap the Debug Info button (orange bug icon) in the top-right toolbar.
2. A bottom sheet opens showing:
   • Scanner Context: Activity, event, and location details
   • Public Keys: Encryption keys used for QR validation
   • Hash Map: Cached activity lookup data
   • Runtime Stats: Total scans, synced, and pending records
3. Tap Copy All to copy all debug information to your clipboard (useful for support requests).
4. Tap Close to return to scanning.

Debug Info is Temporary

This troubleshooting panel is meant for support requests. The information resets when you close the scanner session. Don’t share sensitive key data publicly.

---

Troubleshooting

“Camera permission denied” — The app cannot access your device camera. Go to your phone’s Settings > Apps > Velora > Permissions > Camera and enable it. Restart the app afterward.

“Scanner initialization error” — The app couldn’t load scanning services. Tap Retry on the error screen. If it persists, restart your phone and ensure you have at least 100 MB of free storage.

“Ticket not found” or “Already scanned” — The QR code is valid but this guest was already checked in, or the code is from a different event. Ask the guest to confirm they haven’t been scanned yet. If it’s a duplicate entry, the system prevents double check-ins automatically.

“Invalid token format” — The QR code is damaged, partially obscured, or from an older batch. Ask the guest to show a clearer version or check if they have a physical backup ticket.

“Offline mode” — Your device has no internet connection. Scans still work and will sync automatically when you’re back online. The connection status (green/red dot) shows your current status.

Scanner keeps freezing or resetting — Clear the app cache (Settings > Apps > Velora > Storage > Clear Cache) and try again. If this continues, reinstall the app.

---

Related Articles

• Creating an Activity — Set up scanning-enabled activities
• Managing Your Guest List — Invite and track attendees before scanning
• Understanding Ticket Types — Learn about single vs. multi-entry tickets
• Event Dashboard Overview — View real-time check-in stats
• Offline Event Management — Scan without internet connectivity
• Support & Troubleshooting — Get help from our team
• Mobile App Installation — Set up the scanner on your device