Editing an item

Tap the icon in the list to select it and display additional options at the bottom of the editor. Next, tap the icon md edit to open the properties of the selected item.



The following options are available for the icon:

The text-size and color needs to be set in the settings for the kiosk-dataset, and cannot be set for individual icons.

Type of the kiosk-icon

The first option to set for the icon is to set what should happen when the user taps the icon. Simply put, what should the device do when the user taps the icon?

List of Item types

The following list contains all available types available for a kiosk-item.

List of icon-types

The type None has been created so the items in the kiosk can be placed anywhere on the grid by adding blank entries.
Type Action Additional settings


No functions linked



Displays a folder containing other icons.

Top menu bar title

Enter a title that will be displayed in the kiosk when the folder is opened.


Start an app that has been installed on the device.


Select the app (or apk) to launch or resume.


Data can be used to pass on information to the app that needs to start.

For example, for the ZBOS Survey application, you can enter the name of the data source to start the application with (e.g. _data_source Talemate).

Data is passed on as extras in a startup intent (See: Intent getExtras())


Displays an image in full-screen on the tablet.


Select the image to be shown from the list of uploaded media on the device.


Displays a video (with some controls) on the device.


Select the video-file to play from the list of uploaded media on the device.


Plays a music-file in the background and shows the additional controls.


Select the audio-file to play from the list of uploaded media on the device.


Start playing an uploaded composition


Select the composition to be played from the list of uploaded compositions.


Variables can be used to pass on variables to the composition. This allows you to make dynamic compositions that adapt their behavior based on the given input variables.


Displays a website in the built-in Kiosk


Enter the link to the external website in the additional field.


This option will not be covered in this manual.


Links back to an existing folder in the kiosk.


Select the named folder to navigate back to available folders in the dataset.

Call Help

The device calls for help using the VoIP-system configured on the device.


  • Double-tap the folder-icon to open the content. Tap the back-arrow on the top to return to the folder above the current one.

  • ZBOS Control needs to be connected to a device to load any dynamic content (e.g. list of compositions, media, …​).

  • The media-files and compositions must be stored on the device before they can be linked in a kiosk dataset.

  • Nameless folders will be displayed as (folder) when creating a shortcut.

  • The settings for the VoIP can only be changed in the settings of the device, and cannot be entered in the kiosk dataset.


Tap the option Name to alter the title of the kiosk-item. The name will be displayed in the top-left of the item.

Voice commands

Tap the button Voice commands to open the list of voice commands.


Enter the term the end-user can say in the specified language to start the item in the kiosk. The default entries will not be used for any other language.

The device still needs to be listening by using the wakeword (e.g. OK James) before the device will listen to the command.
The languages for this modal need to be set in the translation-matrix for the kiosk.


Tap the option Icon to select an image stored on the device to be shown as an icon. This icon will be displayed in the bottom-right of the icon.

The default-icon for the app will be shown if no custom icon has been selected.


There are 2 types available for the background for the item, specifically a solid color or a gradient of two colors. Both options use a Color-wheel to select the color(s).


If this option is selected, a color-wheel will be shown where the background-color can be selected. For more information, see the chapter Color-wheel.


If this option is selected, 2 colors can be specified, specifically a top color and a bottom color. The background for the component will then be filled in gradually to flow from the top color into the bottom one.


In this option, you can select the type of action that the device should take once the action linked in the icon has run its course (e.g. video/composition has ended, the app is closed, …​).

A folder cannot be specified as a follow-up action, but a shortcut can be linked to go to the specified folder.



Tap the option Show to show or hide the icon in the kiosk.

Samples of items used in the kiosk

The following samples show some configurations for kiosk-items.


The required application must already be present on the device before it can be selected in the list.
  • Configuration:

  • Output:

  • On tap:

Google Chrome app will be shown.

  • This icon contains the title Browser but is linked to Google Chrome. This can of course be customized further by linking other apps (e.g. Firefox, Safari, …​) to this item.

  • The default icon isn’t displayed in the editor on ZBOS Control, it will only be shown on the device.

Survey dataset

A special case can be made for a Survey dataset, specifically the data_source attribute can be set to launch a specific dataset instead of launching the app showing the selection-screen with all available datasets.

  • Configuration of the item:

  • Tablet-output:

  • On tap:

The survey-app will be shown with the correct dataset loaded.

  • Notes

    • The selected datasource for the survey-app needs to be stored on the device.

    • The Name is capital-sensitive.