# 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. Take Attendance**
## 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)
Go to **Settings > Kiosk mode**. Attendees scan their own QR code in front of the camera.
### 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)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://eventx-hq.gitbook.io/knowledge-base/check-in/check-in-setup/onsite-check-in.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.