Use the scanner app at your venue

Operator

The StandShare Scanner is a Progressive Web App (PWA) designed for checking in workers at venue events using their device camera. It works on phones and tablets, can be installed to the home screen for quick access, and supports offline scanning when connectivity is unreliable.

Accessing the Scanner URL

The scanner URL follows this pattern:

https://{tenant}.standshare.app/scanner/{eventId}

Replace {tenant} with your organization's subdomain and {eventId} with the ID of the event you are staffing. You can find a direct link to the scanner on the event detail page.

tip

Bookmark the scanner URL for each recurring venue event, or share it with your gate staff ahead of time so they can install it before event day.

Installing as a PWA

Installing the scanner to your device home screen provides a native-app experience: it launches full-screen, loads faster, and is available even when you close your browser.

iOS (Safari)

1. Open the scanner URL in Safari.
2. Tap the Share button (the square with an upward arrow).
3. Scroll down and tap Add to Home Screen.
4. Confirm the name (default: "Scanner") and tap Add.

Android (Chrome)

1. Open the scanner URL in Chrome.
2. Tap the three-dot menu in the upper right.
3. Tap Add to Home screen (or "Install app" if prompted).
4. Confirm the name and tap Add.

After installation, a scanner icon appears on your home screen. Tap it to launch directly into the scanner for that event.

Scanning Workflow Step by Step

1. Launch the scanner. Open the PWA from your home screen or navigate to the scanner URL.

2. Grant camera access. On first use, your browser will ask for permission to use the camera. Tap Allow. If you deny permission, the scanner will display an error message. You can reset camera permissions in your device settings.

3. Point the camera at a QR code. The scanner continuously watches for QR codes through the camera viewfinder. When a code is detected, it is processed automatically.

4. Wait for validation. A "Validating..." message appears briefly while the scan is sent to the server.

5. Review the result. The result screen shows one of three states:

   Result	Color	Meaning
   Approved	Green	Worker verified and checked in. Name, organization, and photo are displayed.
   Warning	Yellow	Scan accepted with a flag. Check with the coordinator for details.
   Denied	Red	Scan rejected. Reason displayed (e.g., invalid credential, not assigned).

6. Dismiss and scan the next worker. Tap anywhere on the result screen to return to the camera viewfinder.

Manual Search Fallback

If a worker cannot present their QR code, use the manual search:

1. Tap Manual search below the camera viewfinder.
2. Type the worker's name. The search uses a locally cached roster, so it works even without a network connection.
3. Select the correct result. The worker is checked in and queued for sync.

For full details on the manual search and check-in overrides, see QR Check-In at Venues.

Offline Mode

The scanner is built to handle intermittent connectivity. Here is what happens when your device goes offline:

Detection

The scanner monitors network status in real time. When connectivity drops, the status indicator in the header changes from Online (green dot) to Offline (gray dot).

Scanning While Offline

You can continue scanning QR codes while offline. Each scan is stored locally in an IndexedDB database on your device with the following information:

• A unique offline ID.
• The raw QR credential data.
• The event ID.
• The timestamp of when the scan occurred.

The result screen displays a yellow warning with the message: "Offline scan queued -- Will sync when connection is restored."

A pending sync badge in the header shows the number of scans waiting to be uploaded (e.g., "3 pending sync").

What Is Not Available Offline

• Server-side validation (the green "Approved" result) requires a network connection. Offline scans are queued and validated later.
• The roster search uses locally cached data, so manual search still works. However, if the roster was never cached (e.g., you opened the scanner for the first time without any network), the roster will be empty.

Sync Behavior When Back Online

When the device reconnects to the network:

1. Automatic sync triggers immediately. The scanner detects the online event and begins uploading queued scans.
2. Batch upload. All pending scans for the event are sent to the server in a single request. Each scan includes the original timestamp, so the check-in time is accurate even if the sync happens minutes or hours later.
3. Pending count resets. After a successful sync, the pending badge disappears.
4. Periodic retry. Even while online, the scanner runs a background sync every 30 seconds to catch any scans that may have been missed.

If a sync attempt fails (e.g., intermittent connection), the scans remain in the local database and will be retried on the next interval or when connectivity stabilizes.

Troubleshooting

Issue	Solution
Camera shows a black screen	Ensure camera permissions are granted in your device settings. Close other apps that may be using the camera.
"Camera permission denied" error	Go to your browser or device settings, find camera permissions for the StandShare site, and change to Allow. Then reload the page.
Scans are not syncing	Check the online indicator. If it shows "Offline," move to an area with better connectivity. If it shows "Online" but scans are still pending, reload the page to trigger a sync.
QR code not detected	Ensure the QR code is well-lit and the camera is focused. Hold the device steady, about 6-10 inches from the code.
Worker not found in manual search	The roster may not have been cached. Connect to the network and reload the scanner page to refresh the roster cache.

Cross-Reference

The scanner PWA is shared between operator staff and NPO coordinators. For the coordinator perspective on scanner usage, see Scanner PWA for Coordinators. The core scanning workflow is identical; the difference is in which events are accessible based on your role.

Next Steps

• Getting Started — New to StandShare? Start here
• Reference — Look up terms and statuses