Kiosk Displays

Displays are the physical devices deployed at reception desks — iPads, Android tablets, or touchscreen monitors — that power the self-service check-in experience. Each display is registered in Visitor, paired to a location, and configured with a display mode.

Display Modes

Visitor supports five display modes for different deployment scenarios:

Mode	Use Case
Check-In Kiosk	Self-service visitor check-in at reception
Lobby Directory	Staff and department directory for wayfinding
Status Board	Shows currently checked-in visitors (for security or reception)
Welcome Screen	Branded welcome message for reception area
Wayfinding	Directional signage for large offices or conference centers

Display Statuses

Status	Meaning
online	Device connected recently (last seen within the refresh interval)
offline	Device has not connected for an extended period
paused	Display has been manually paused by an admin

Setting Up a New Display

Step 1: Create the Display Record

1. Click Displays in the left navigation
2. Click Add Display
3. Fill in:
   • Name — descriptive name, e.g., "Main Lobby Kiosk" or "Conference Level Wayfinding"
   • Location — which office this display belongs to
   • Display Mode — the type of display (Check-In Kiosk, Lobby Directory, etc.)
4. Click Save

A 6-digit device code is generated and shown in the display record.

Step 2: Pair the Device

1. On your tablet or touchscreen, open a browser and navigate to the kiosk URL shown in the display record
2. Enter the 6-digit device code when prompted
3. The device downloads the display configuration and an access token is generated (valid 365 days)
4. The display mode activates on the device screen

The device is now paired. It appears in the Displays list with status online.

ℹ️The device code is single-use and expires after pairing. If you need to pair a replacement device, go to the display record and click Re-Pair to generate a new code.

Display Settings

Each display can be configured independently:

Setting	Description	Default
Theme	Dark or light color scheme	Dark
Refresh Interval	How often the display polls for updates (seconds)	30
Show Clock	Display current time on screen	Yes
Show Logo	Display organization logo	Yes
Welcome Message	Custom greeting text shown on idle screen	(none)
Idle Timeout	Seconds before returning to idle/welcome screen	60
Fullscreen on Load	Enter fullscreen mode automatically	Yes
Rotation Seconds	For multi-screen rotation (status boards)	(none)
Widgets	Additional content panels (status boards)	(none)

To update settings:

1. Click Displays → click the display name
2. Click Edit
3. Adjust settings
4. Click Save — the display picks up the new configuration on its next refresh interval

Check-In Kiosk Flow

When a display is in Check-In Kiosk mode, visitors see the following flow:

1. Welcome screen — shows organization name and a "Check In" button
2. Name entry — visitor types their full name
3. Host selection — visitor browses or searches the host directory
4. Visit details — visitor selects purpose (Meeting, Delivery, etc.) and enters company name
5. Confirmation — check-in confirmed; host is notified
6. Return to idle — display returns to welcome screen after the idle timeout

The kiosk uses the public /api/kiosk/* endpoints, which authenticate via the device's access token (X-Display-Token header). No Hub credentials are needed on the device.

Managing Multiple Displays

If you have multiple displays at the same location (e.g., two reception kiosks), create a separate display record for each. Each device gets its own access token, and their last_seen_at timestamps are tracked independently.

For organizations with displays at multiple locations, use the Location filter on the Displays page to focus on one site at a time.

Replacing or Retiring a Device

Replacing a Device (Re-Pairing)

If a device is lost, stolen, or replaced:

1. Click Displays → find the display
2. Click Re-Pair — a new device code is generated
3. The old device's access token is invalidated
4. Pair the new device using the new code

Retiring a Display

If a location closes or a display is permanently removed:

1. Click Displays → find the display
2. Click Delete
3. The display record is soft-deleted; historical check-in records from the kiosk are preserved

Kiosk Hardware Recommendations

Visitor's kiosk mode works in any modern browser. Recommended hardware:

Device Type	Notes
iPad (10" or 12.9")	Ideal — mount in a kiosk enclosure at reception
Android tablet (10"+)	Works well; use a kiosk lockdown app to prevent navigation away
Windows touchscreen monitor	Good for larger lobbies; use Chrome in fullscreen mode
Dedicated kiosk terminal	Any browser-based kiosk appliance works

For best results, configure the device to auto-restart the browser and prevent visitors from navigating away from the kiosk URL.