> For the complete documentation index, see [llms.txt](https://eventx-hq.gitbook.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eventx-hq.gitbook.io/knowledge-base/check-in/check-in-setup/onsite-check-in.md).
# Onsite Check-in
## Setup Requirements
**Software**
* iOS 18+, iPadOS 17+ or Android 10+
* Not available on China app stores (Huawei, Xiaomi, etc.)
* Translation: 4 languages only (English, Korean, Simplified Chinese, Traditional Chinese) — cannot switch language on iPad
**Hardware** (Apple devices recommended)
* iPad mini 5th gen+, iPad Air 3rd gen+, iPad 7th gen+, iPad Pro
* iPhone 12th gen+
* [Supported models list](https://support.apple.com/en-hk/102772)
**WiFi**: 50 Mbps minimum
## Getting Started
**1. Download the App**
[iOS App Store](https://apps.apple.com/us/app/eventx-check-in/id1589358447)
[Google Play Store](https://play.google.com/store/apps/details?id=io.eventx.esaas.checkin\&hl=en\&gl=US)
**2. Open the App**
**3. Scan the QR Code** — Go to **In-person Check-in** on the portal, open the **Tutorial** tab, scan the QR\
code.
**4. Scan Attendance QR Code**
## Features
### Event Status
4 numbers on the left:
* **Attended** — checked in
* **Not Attended** — not yet arrived
* **At the Venue** — currently inside
* **Checked-out** — left the venue
### Attendee Status Indicators
| Icon | Meaning |
| ------------------- | -------------------- |
| Green check | At the venue |
| Gray check with dot | Checked out |
| Block sign | Blocked by organizer |
### Filtering
Filter attendees by:
* Check-in status, Walk-in source, Ticket type, Add-on items, Tags, Custom fields
### Check-in Methods
**By QR Code**
1. Tap the red scan icon
2. Scan the attendee's QR code
3. Session name appears at top — tap to switch sessions
4. Tap **Scanned History** to check past scans
**By Name Search** Search by: name, email, organization, job title, phone, order ID, or promo code. Tap the tick icon to check in.
**Walk-in** (unregistered attendees)
1. Tap **+ WALK IN**
2. Fill the form
3. Tap **Submit**
Walk-in form settings are on the portal under **In-person Check-in > Walk-in Form Fields**.
### Manage Attendee Profile
Tap attendee name → **Edit** → update info → **Save**
What you can view:
* Personal info (name, email, contact)
* Custom fields from registration
* Order details (ID, purchaser, promo code, payment)
* Ticket type, Add-on items
* Check-in/out times
### Breakout Sessions
Switch sessions from **Sessions Reception** to track attendance for multi-day events.
### Kiosk Mode (Self Check-in)
Attendees can check themselves in by scanning their QR code on a shared iPad — no staff needed. See [Kiosk Mode Detail](/knowledge-base/check-in/check-in-setup/kiosk-mode.md).
### Sorting
Sort by: Latest check-in time, Name A-Z, or Created date.
### Pre-printing
**Bulk (up to 200 badges)**
1. Select the correct session/filter
2. Tap **Bulk Printing**
3. Confirm — progress bar shows
**Individual** Tap attendee name → tap print icon.
### Custom QR Code
Import 3rd party QR codes (e.g. Eventbrite) via CSV:
* Column header: `Custom Check In Token [customCheckInToken]`
* Each string must be unique per event
### Display Custom Lines
Choose what to show below each attendee name. Go to **In-person Check-in > Custom Line**. Supported: name, email, phone, job title, organization, country, city, ticket type, custom fields, tags. Not supported: consent questions.
### Cool Down Logic
Prevents scanning the same QR code twice within 1 second.
### WiFi Network Display
App v5.3.14+ shows the connected WiFi name. Enable location permissions to use this.
### Device ID
Each device shows a unique ID. Share it with support for troubleshooting.
### Offline Mode
Works without internet. Data auto-syncs when connection is restored.
## Error Messages
| Scenario | Message |
| -------------------------- | --------------------------------------------------------------------------------------- |
| Attendee is blocked | Sorry this attendee has been blocked, please contact organiser. |
| Not in attendee list | Sorry, this attendee is not inside attendee list, please double check again |
| Not in breakout session | Sorry, this attendee is not permitted to this session, please double check again. |
| Check-out with no check-in | Sorry, this attendee is not yet check in, you cannot proceed to checkout directly. |
| Invalid QR code | Sorry, this QR Code is not compatible with EventX system, please use the valid QR Code. |
| Test badge scanned | Testing badge scanned, please check-in with attendee QR Code. |
| Unknown error | Sorry, unknown error occured |
| Attendee removed | Sorry, this attendee record has been removed, please check with organiser. |
## Limitations
* Cannot edit ticket type or custom fields (e.g. table number) on iPad
* Cannot do full text search — only fuzzy search (e.g. "apple boy" matches "apple boy cat" but not "boy apple cat")
* Bulk printing limited to 200 badges at once
* No walk-in OCR
* Supports up to 10k attendees, 50 sessions, 10 custom fields, 10 tickets (stress tested)
## Frequently Asked Questions
### Q: Can I check in attendees without an internet connection?
**A:** Yes. The Check-in App supports offline mode. Attendee data is cached locally and syncs when connectivity is restored.
### Q: What's the maximum number of badges I can print at once?
**A:** Bulk printing is limited to 200 badges at a time.
### Q: Can I edit an attendee's ticket type from the Check-in App?
**A:** No. Ticket type and custom fields (e.g., table number) cannot be edited on the iPad. Use the organizer portal to make these changes.
### Q: What is Kiosk Mode?
**A:** Kiosk Mode allows attendees to check themselves in by scanning their QR code on a shared iPad — no staff needed. See [Kiosk Mode Detail](/knowledge-base/check-in/check-in-setup/kiosk-mode.md).
### Q: Which languages does the Check-in App support?
**A:** 4 languages: English, Korean, Simplified Chinese, Traditional Chinese. The language cannot be switched on the iPad — it follows the event's language setting.