Kiosk mode lets you replace the home screen on your Cisco device with your own custom web application that you host and maintain yourself.


  • Kiosk mode is not supported on Desk Hub, DX70, or DX80.

As an example, Kiosk mode can be used in reception areas where you want to display your own branding to enhance the first-time experience, while controlling the user experience on the Cisco device.

Setting the device to Kiosk mode makes it possible to disable the non-video functions, such as whiteboarding and screensharing, and to prevent users from changing the device settings.

Typical flow of a kiosk use case:

In Kiosk mode, you can still make calls with the device. In a call, the user experience is the same as in any call, but as soon as the call is ended, the device goes back to the kiosk web app.

Typical use cases could be:

  • Virtual receptionist

  • Visitor registration

  • Facility overview

  • Remote expert services

Configuring Kiosk mode

Set up the device for Kiosk mode through the xAPI.

  1. Start by enabling the Web Engine, which is necessary for displaying web apps.

    xConfiguration WebEngine Mode: On

  2. Specify the URL of your web app.

    xConfiguration UserInterface Kiosk URL: "www.cisco.com"

    If the kiosk is not able to access the URL, it will display a service mode page. The page also displays the IP address of the device and a retry button.

  3. Turn on Kiosk mode.

    xConfiguration UserInterface Kiosk Mode: On

    You should now see your web app as the new home screen.

Recommended settings

You can fine-tune your device's behavior by setting configurations through the xAPI. We recommend you always set the following:

  1. Lock access to items on the Settings panel. Settings that require authentication will display a padlock icon.

    xConfiguration UserInterface SettingsMenu Mode: Locked

    xConfiguration UserInterface Security Mode: Strong

    This requires that you set a passphrase for all user accounts with administrator rights.

  2. Disable the voice assistant:

    xConfiguration UserInterface Assistant Mode: Off

  3. Turn off ultrasound to prevent Webex apps from pairing with the device:

    xConfiguration Audio Ultrasound MaxVolume: 0

Allowing calls

To allow for making calls from your web app, turn on the SIP URL handler setting:

  • xConfiguration WebEngine Features SipUrlHandler: On

Then, you can add links to your web app using the sip protocol. For example:

  • <a href="sip:erica.talking@ivr.vc">Call Erica</a>

Accessing the Settings panel

The Settings panel is hidden when the device is in Kiosk mode. As an Admin user, you may want to access it and see the IP address, diagnostic messages, or other settings. To open the Settings panel, tap three times with three fingers on the screen.

This gesture is not intended as a security feature but is just to reduce the chance of inadvertent changes being made to the settings. To further reduce this risk, you can lock the Settings panel with:

  • xConfiguration UserInterface SettingsMenu Mode: Locked
  • xConfiguration UserInterface Security Mode: Strong

Setting up cable preview when not in a call

When the system is not in a call, there's no on-screen control for the local cable preview.

If xConfiguration Video Input Connector [X] PresentationSelection is set to Desktop, OnConnect, or AutoShare, the cable preview will continue unless you disconnect the cable or use the command xCommand Presentation Stop. This is the only way to return to the main kiosk page.

When xConfiguration Video Input Connector [X] PresentationSelection is set to Manual, cable connection won't show content. To preview content, use xCommand Presentation Start. Stop by disconnecting the cable or using xCommand Presentation Stop.

During a call, use the RoomOS Interface and the Share button to control cable sharing.

Other settings

In Kiosk mode, the system will never enter half wake state, but it will go to standby after the specified number of minutes. To disable standby mode:

  • xConfiguration Standby Control: Off

You can further tune your settings to whatever makes sense for the location and use of your kiosk. For example, to enable noise removal:

  • xConfiguration Audio Microphones NoiseRemoval Mode: Enabled

You can disable speaker tracking, for example:

  • xConfiguration Cameras SpeakerTrack Mode: Off

To hide the standard in-call buttons:

  • xConfiguration UserInterface Features HideAll: True

Or, to hide specific buttons, for example:

  • xConfiguration UserInterface Features Call End: Hidden
  • xConfiguration UserInterface Features Share Start: Hidden

Restore the kiosk after each user

Ensure that your web app restores the kiosk to the home screen after a few minutes of inactivity.

This can be done with common web patterns, such as listening for touch events on the body element of the web page, resetting a timer each time a user touches the screen, and resetting the kiosk, if the timer reaches zero.