Kiosk Mode
Document Version: 1.0
Last Updated: January 2026
Purpose: Covers all use cases for Kiosk Mode check-in, including setup, user flows, and troubleshooting.Overview
1. Initial Setup (Administrator)
Prerequisites:
- Admin access to the church dashboard
- A tablet or iPad for the kiosk station
Steps:
| Step | Action |
|---|---|
| 1 | Navigate to Admin Dashboard → Kiosk Management |
| 2 | Click the Settings tab |
| 3 | Copy your Kiosk URL (format: https://oriapp.co/kiosk/your-church-slug) |
| 4 | Set a 4-digit Fullscreen Lock Code (prevents students from exiting) |
| 5 | Click Save Settings |
| 6 | On your kiosk device, open the Kiosk URL in a browser |
| 7 | Bookmark the page for quick access |
| 8 | Tap the fullscreen button (top-right corner) to enter kiosk mode |
Security Notes:
- The lock code is required to exit fullscreen mode
- Share the lock code only with authorized leaders
- Default code is “0000” if not set
2. Use Case: Returning Student Check-In
Scenario: A student who has already registered returns for another event.
Flow:
Welcome Screen → Tap "Check In" → Enter 6-digit code → Success!
Detailed Steps:
| Step | Screen | Action |
|---|---|---|
| 1 | Welcome | Student taps “Check In” |
| 2 | Code Entry | Student enters their 6-digit personal code |
| 3 | Processing | System validates the code against the church’s users |
| 4 | Success | Student sees welcome message, XP earned, and streak days |
| 5 | Reset | After tapping “Next Student” or 30 seconds of inactivity, screen returns to Welcome |
Error Handling:
- Invalid Code: Student sees “Invalid code. Please try again.”
- Too Many Attempts (5+ failures): 30-second lockout with countdown timer
- Forgot Code: Tap “Forgot your code?” to get help (see Use Case 4)
3. Use Case: New Student Registration
Scenario: A first-time visitor needs to create an account at the kiosk.
Flow:
Welcome Screen → Tap "New Here? Register" → Enter email + name → Choose 6-digit code → Success!
Detailed Steps:
| Step | Screen | Action |
|---|---|---|
| 1 | Welcome | Student taps “New Here? Register” |
| 2 | Info Entry | Enter email address and name |
| 3 | Validation | System validates email format and name length |
| 4 | Code Selection | Student chooses their own 6-digit code (birthday, phone digits, memorable number) |
| 5 | Processing | System creates account and checks in the student |
| 6 | Success | Student sees welcome message + reminder to verify email within 3 days |
Important Notes:
- Students must verify their email within 3 days or their account may be deactivated
- If a code is already taken, the student must choose a different one
- Email addresses are converted to lowercase automatically
4. Use Case: Forgot Code Recovery
Scenario: A student can’t remember their check-in code.
Flow:
Code Entry Screen → Tap "Forgot your code?" → Enter email → Leader notified → Find leader for help
Detailed Steps:
| Step | Screen | Action |
|---|---|---|
| 1 | Code Entry | Student taps “Forgot your code?” |
| 2 | Email Entry | Student enters their registered email address |
| 3 | Processing | System looks up the account and notifies a leader |
| 4 | Success | Student sees “Leader Notified!” message |
| 5 | Next Steps | Student finds a nearby leader who has received their code |
What Leaders Receive:
- The student’s name
- Their email address
- Their 6-digit kiosk code
If Email Not Found:
- Student sees: “Could not find your account. Please check your email.”
- Options: Try again with correct email, or register as a new user
5. Use Case: Exiting Kiosk Mode (Leaders Only)
Scenario: A leader needs to access other browser functions or troubleshoot.
Flow:
Tap lock icon (top-right) → Enter 4-digit admin code → Exit fullscreen
Detailed Steps:
| Step | Action |
|---|---|
| 1 | Tap the lock icon in the top-right corner |
| 2 | A dialog appears requesting the 4-digit admin lock code |
| 3 | Enter the code set in Admin Settings |
| 4 | If correct, fullscreen mode exits |
| 5 | To re-enter kiosk mode, tap the maximize icon (top-right) |
Notes:
- If no lock code is set, anyone can exit fullscreen
- The lock icon only appears when in fullscreen mode
6. Managing Kiosk Users (Administrator)
Location: Admin Dashboard → Kiosk Management → Users tab
Available Actions:
| Action | Description |
|---|---|
| Search | Find users by name, email, or code |
| Manual Verify | Verify a student’s email if they’re having trouble with the verification email |
| Extend Deadline | Give a student more time to verify their email |
| Change Code | Generate a new 6-digit code for a student (if theirs is compromised) |
| View Status | See verification status, deadlines, and registration dates |
User Status Indicators:
- Green checkmark: Email verified
- Yellow clock: Awaiting verification (shows time remaining)
- Red X: Verification expired
7. Troubleshooting
| Issue | Solution |
|---|---|
| Kiosk URL not loading | Verify the church slug is correct; check internet connection |
| “Church not found” error | Confirm the slug matches Admin Dashboard → Settings |
| Fullscreen not working | Ensure browser supports Fullscreen API; try a different browser |
| Code not recognized | Verify student is entering code for correct church; check Admin dashboard for their code |
| Too many failed attempts | Wait 30 seconds for lockout to expire, or restart the kiosk |
| Student can’t verify email | Use Admin Dashboard to manually verify or extend deadline |
8. Best Practices
- Position the kiosk in a visible, accessible location near the entrance
- Use a tablet stand or mount for stability
- Keep the lock code private—share only with authorized leaders
- Check the Admin Dashboard regularly for unverified users who may need help
- Remind new students to verify their email when they get home
- Have a leader nearby during high-traffic times to assist with forgotten codes