Kiosk Component
The Kiosk Policy Component allows you to lock devices into a controlled kiosk experience. It enables control over navigation, system UI visibility, hardware buttons, launcher behavior, and advanced kiosk layouts.
Use this component when you want to configure devices for single app mode, multi app kiosk mode, or fully customized enterprise kiosk experiences.
Kiosk Customization
Kiosk Customization
API reference: kioskCustomization
Controls system UI, hardware buttons, and settings accessibility in kiosk mode.
Power Button Actions
API reference: kioskCustomization.powerButtonActions
| Option | API reference | Description |
|---|---|---|
| Default | POWER_BUTTON_ACTIONS_UNSPECIFIED | Uses device default behavior. |
| Available | POWER_BUTTON_AVAILABLE | Power button works normally. |
| Blocked | POWER_BUTTON_BLOCKED | Power button interaction is restricted. |
System Error Warnings
API reference: kioskCustomization.systemErrorWarnings
| Option | API reference | Description |
|---|---|---|
| Default | SYSTEM_ERROR_WARNINGS_UNSPECIFIED | Uses default device behavior. |
| Enabled | ERROR_AND_WARNINGS_ENABLED | Shows system errors and warnings. |
| Muted | ERROR_AND_WARNINGS_MUTED | Suppresses system error dialogs. |
System Navigation
API reference: kioskCustomization.systemNavigation
| Option | API reference | Description |
|---|---|---|
| Default | SYSTEM_NAVIGATION_UNSPECIFIED | Uses device default navigation. |
| Enabled | NAVIGATION_ENABLED | Allows full navigation access. |
| Disabled | NAVIGATION_DISABLED | Blocks navigation buttons and gestures. |
| Home button only | HOME_BUTTON_ONLY | Only home navigation allowed. |
Status Bar Controls
API reference: kioskCustomization.statusBar
| Option | API reference | Description |
|---|---|---|
| Default | STATUS_BAR_UNSPECIFIED | Uses device default behavior. |
| Enabled | NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED | Shows notifications and system info. |
| Disabled | NOTIFICATIONS_AND_SYSTEM_INFO_DISABLED | Hides status bar notifications and info. |
| System info only | SYSTEM_INFO_ONLY | Shows system info without notifications. |
Device Settings Access
API reference: kioskCustomization.deviceSettings
| Option | API reference | Description |
|---|---|---|
| Default | DEVICE_SETTINGS_UNSPECIFIED | Uses device default behavior. |
| Allowed | SETTINGS_ACCESS_ALLOWED | User can open device settings. |
| Blocked | SETTINGS_ACCESS_BLOCKED | Settings access is restricted. |
Kiosk Custom Launcher
Kiosk Custom Launcher
API reference: kioskCustomLauncherEnabled
Controls whether custom kiosk launcher mode is enabled.
Enable Custom Launcher
| Option | API reference | Description |
|---|---|---|
| Enable custom launcher | boolean | Enables kiosk launcher experience. |
Kiosk Type
API reference: kioskType
Available only if Advanced Kiosk feature is enabled in the plan and reseller supports it.
| Option | API reference | Description |
|---|---|---|
| Native | NATIVE | Standard Android kiosk mode. |
| Advanced | ADVANCED | Advanced customizable kiosk experience. |
Advanced Kiosk Configuration
Advanced Kiosk Configuration
API reference: advancedKioskManagedConfig
Provides advanced UI layout customization, theme configuration, orientation behavior, and message display.
Kiosk Orientation
API reference: advancedKioskManagedConfig.kiosk_orientation
| Option | API reference | Description |
|---|---|---|
| Auto | AUTO | Device automatically adjusts orientation. |
| Portrait | PORTRAIT | Locks device to portrait mode. |
| Landscape | LANDSCAPE | Locks device to landscape mode. |
Background Configuration
API reference: advancedKioskManagedConfig.kiosk_theme_configuration
| Option | API reference | Description |
|---|---|---|
| Color | COLOR | Uses solid background color. |
| Image | IMAGE | Uses background image. |
Kiosk Message Configuration
API reference: advancedKioskManagedConfig.kiosk_message_configuration
| Field | API reference | Description |
|---|---|---|
| Message | kiosk_message | Text message displayed on kiosk screen. |
| Message location | kiosk_message_location | Position of message. |
Message Location Options
| Option | API reference | Description |
|---|---|---|
| Top | TOP | Message shown at top of screen. |
| Bottom | BOTTOM | Message shown at bottom of screen. |
Kiosk Layout Configuration
Kiosk Layout Configuration
API reference: advancedKioskManagedConfig.kiosk_layouts_configuration
Controls application placement and screen layout design.
Layout Setup Mode
API reference: mode
| Option | API reference | Description |
|---|---|---|
| Manual | MANUAL | Admin manually designs layout. |
| Auto | AUTO | System automatically arranges layout. |
Manual Layout Configuration
Available when layout mode is MANUAL.
| Field | API reference | Description |
|---|---|---|
| Rows | rows | Number of app rows. |
| Columns | columns | Number of app columns. |
| Pages | pages | Number of layout pages. |
App Mapping
Defines app placement per grid coordinate and page.
Format: column x row x page
Example: 2x3x1 → Column 2, Row 3, Page 1
Summary
Use the Kiosk Policy Component to:
- ✔ Lock devices into kiosk mode
- ✔ Control navigation, system UI, and hardware buttons
- ✔ Enable standard or advanced kiosk launchers
- ✔ Customize kiosk layouts and UI appearance
- ✔ Configure kiosk branding and messaging
- ✔ Control application placement and layout
This component is essential for retail devices, POS systems, digital signage, field workforce devices, and enterprise kiosk deployments.