ZenotiHelp

Mirror Mode β€” Session Coordinator and Exit Routing

ZTZenoti Docs Team Updated November 2, 2026 8 min readGuide

When a mirror session ends on the guest kiosk, Zenoti automatically aborts any in-progress payment surface and routes the kiosk to the correct screen β€” either the mirror idle screen or the configured home screen β€” without requiring operator intervention. This article explains what happens when a mirror session ends, how the exit routing behavior is controlled, and how the front desk's mirror session interrupts a guest flow already in progress.

Audience: Center administrators and front desk staff who manage guest kiosk devices running in mirror mode.


On this page


Before you begin

  • The guest kiosk must be enabled at both the organization level and the center level before mirror mode is available. For details, see Set up and configure the guest kiosk.
  • Mirror mode requires the new kiosk. The Enable new Kiosk setting must be on at both the organization level and the center level. For gating details, see Enable New Kiosk β€” Organization and Center Gating.
  • Confirm whether Keep mirror mode always on is enabled on your kiosk device. This per-device setting controls where the kiosk navigates after a mirror session ends.
  • No staff RBAC permissions are required to observe mirror session exit behavior from the guest-facing kiosk. Accessing and changing Keep mirror mode always on on the device requires entering the account name on the device via the kiosk app's own Admin settings screen β€” no Zenoti staff security role or RBAC permission is required.

Important: Mirror mode is a display feature of the guest kiosk. Do not confuse it with the staff-facing queue, which manages appointment flow separately. For queue management, see the front-desk-queue documentation.


How mirror session exit works

When a mirror session ends β€” for example, because the front desk closes the mirrored invoice β€” the kiosk performs two actions in sequence:

  1. It aborts any in-progress payment surface.
  2. It routes to the appropriate screen based on whether Keep mirror mode always on is enabled on the device.

Both actions happen automatically. The operator does not need to intervene or manually reset the kiosk between sessions.


Payment surface abort on session end

When a mirror session ends while a payment is in progress, the kiosk immediately aborts the active payment surface before navigating away. This ensures the payment state is cleanly reset for the next guest.

What this means in practice:

  • If a guest reaches the payment step β€” for example, the Select Payment Method or Processing Payment screen β€” and the session ends before the transaction completes, the kiosk cancels the in-progress payment interaction.
  • The kiosk does not leave a partial payment state on screen.
  • No staff action is required to clear the payment surface.
  • The next guest session starts from a clean state.

Note: The payment abort on session end applies to the kiosk's self-service payment surface only. For reconciling incomplete transactions in the POS, see Process payments at the kiosk.

Worked example

A guest reaches the Select Payment Method screen and selects Use card reader & pay. Before the card is presented, the mirror session ends. The kiosk immediately aborts the card reader payment surface, clears the screen, and routes to the post-session destination. The transaction is not recorded and does not appear as a failed payment requiring manual clearance.


Post-session routing behavior

After the payment surface is aborted and the session ends, the kiosk navigates to one of two destinations depending on whether Keep mirror mode always on is enabled on the device.

The following table summarizes the routing logic:

Keep mirror mode always on setting Post-session destination
Enabled Mirror idle screen
Disabled Configured home screen

When Keep mirror mode always on is enabled

The kiosk routes to the mirror idle screen after each session ends. The device remains in mirror mode between guest sessions. This is the recommended configuration for centers where the kiosk is permanently deployed in a high-traffic area and should always display the mirror idle state.

When Keep mirror mode always on is disabled

The kiosk routes to the configured home screen after each session ends. The device exits mirror mode after the session concludes. This configuration suits centers that use mirror mode selectively rather than continuously.

Tip: If your kiosk is mounted in a fixed location and intended to run continuously, enable Keep mirror mode always on so the device returns to the mirror idle screen automatically after every guest session without requiring staff to reset it.


How front desk checkout interrupts a guest flow

When the front desk opens a mirrored invoice, the kiosk immediately takes over the screen. This interruption is unconditional β€” it occurs regardless of what the guest is currently doing on the device.

What is interrupted:

Any guest flow in progress is interrupted and discarded when the front desk opens a mirrored invoice. This includes:

  • Check-in
  • Booking
  • Self-checkout
  • Form filling

Any details the guest had entered during those flows are discarded at the moment of interruption. The kiosk then displays the front desk's checkout screen for the duration of the mirror session.

Important: Guests in the middle of filling out a form or entering payment details will lose their progress when the front desk opens a mirrored invoice. Center staff should be aware that triggering a mirror session while a guest is actively using the kiosk will interrupt and discard the guest's current flow. If possible, wait for the guest to complete their interaction before opening a mirrored invoice, or direct the guest to the front desk to complete their transaction there.

The mirror session continues until the front desk closes the mirrored invoice, at which point the payment surface abort and post-session routing described above occur.


Keep mirror mode always on β€” per-device setting

Keep mirror mode always on is a per-device setting stored on the kiosk device itself. It is not an organization or center setting in the Zenoti web console.

Key characteristics of this setting:

  • It is accessed and changed via the kiosk app's own Admin settings screen.
  • To open Admin settings, enter the account name on the device via the account-name dialog that the screen presents. No Zenoti staff security role or RBAC permission is required.
  • The setting is stored on the device. It is not synchronized across multiple kiosk devices β€” each device has its own independent value.
  • The setting is cleared in the following situations:
    • App restart
    • Logout
    • When the mirror screen is closed

Because the setting is cleared on app restart, logout, or when the mirror screen is closed, you will need to re-enable it after any of those events if your center requires continuous mirror mode routing.

Note: For details on configuring the Keep mirror mode always on toggle and related mirror mode settings, see Mirror Mode β€” Always-On and Ad URL Settings and Admin Settings panel.


Tips

  • Confirm your routing preference before go-live. Decide whether your center needs the kiosk to return to the mirror idle screen or the home screen between sessions, and enable or disable Keep mirror mode always on on each device accordingly before guests begin using the kiosk.
  • Re-enable Keep mirror mode always on after app restarts or logouts. Because the setting is cleared on app restart, logout, and when the mirror screen is closed, check each device after any of those events if your center relies on the mirror idle screen routing.
  • Monitor the first few sessions after enabling mirror mode. Verify that the kiosk is landing on the expected post-session screen and that no payment surfaces are left visible between sessions.
  • Use the mirror idle screen as a branding opportunity. When Keep mirror mode always on is enabled, the mirror idle screen is what guests see between sessions. Ensure your kiosk branding and display settings are configured to present the intended idle state. See Customize kiosk branding and display.
  • Inform front desk staff about guest flow interruption. When the front desk opens a mirrored invoice, any guest interaction in progress on the kiosk is immediately discarded. Train front desk staff to check the kiosk screen before opening a mirrored invoice and, where possible, to wait for the guest to complete their interaction first.
  • Do not assume the kiosk requires a manual reset after each session. The payment abort and routing both happen automatically. If you observe the kiosk not resetting correctly, use the troubleshooting steps below rather than manually restarting the device.

Troubleshooting

The kiosk shows a payment screen between sessions instead of routing away.

The payment surface abort should happen automatically when a mirror session ends. If the kiosk remains on a payment screen:

  • Confirm that the mirror session actually ended rather than timing out to the idle prompt (Still here?). The session is still active if the idle prompt is visible β€” tapping I'm here resumes it.
  • Check whether the session ended cleanly or was interrupted by a network disruption. A loss of connectivity mid-session can prevent the abort sequence from completing.
  • If the payment surface persists, restart the kiosk application and verify that your network connection is stable before the next guest session. Note that restarting the app clears the Keep mirror mode always on setting β€” re-enable it on the device after the restart if needed.

After a session ends, the kiosk routes to the home screen instead of the mirror idle screen.

  • Verify that Keep mirror mode always on is enabled on the device via the kiosk app's Admin settings screen. If the setting is disabled, routing to the home screen is the expected behavior.
  • Check whether the app was restarted, a logout occurred, or the mirror screen was closed since the setting was last enabled. Any of those events clears the setting, and it must be re-enabled manually.
  • If the setting appears enabled but the kiosk still routes to the home screen, confirm that Enable new Kiosk is active at both the organization and center level, as mirror mode requires the new kiosk. See Enable New Kiosk β€” Organization and Center Gating.

After a session ends, the kiosk routes to the mirror idle screen but the display is blank or frozen.

  • This may indicate a display or rendering issue unrelated to the session exit routing. Restart the kiosk application.
  • Note that restarting the app clears the Keep mirror mode always on setting β€” re-enable it on the device after the restart if the device should continue routing to the mirror idle screen.
  • If the issue persists, check the device's network connectivity and confirm that the kiosk software is up to date.

A guest's form or booking data was discarded unexpectedly.

  • If a guest reports that their form answers or booking selections were lost, the most likely cause is that the front desk opened a mirrored invoice while the guest was actively using the kiosk. The interruption is immediate and unconditional, and any data the guest had entered is discarded.
  • Ask the guest to restart their flow from the beginning.
  • To reduce the frequency of this situation, train front desk staff to check the kiosk screen before opening a mirrored invoice and, where possible, to wait for the guest to complete their interaction first.

Was this article helpful?
Your feedback helps us improve our documentation.