Kiosk Browser - Automatic Configuration JSON
The automatic config feature in Kiosk Browser allows you to specify a Url (Settings > Advanced) where Kiosk Browser will check for config changes every 15 mins. For example https://www.android-kiosk.com/kbconfig.json This allows you to keep your devices configured consistently but also allows you to easily make changes.
The below list of properties is a complete list of all configuration properties. They are all optional, if you do not include a specific property, the default setting from Kiosk Browser is used instead. If you have already configured a device with the required settings you can export your config to a JSON file stored publicly on our servers for 15 minutes. Go to Settings > Admin > Create Automatic Configuration File.
Licensing
You can automatically activate licences via JSON property as per below:
{
"licence_key": "12345"
}
Example Properties
{
"kiosk_url": "https://www.google.com",
"custom_app_title":"Kiosk Browser",
"hyperlink_sound": true,
"enable_timeout": true,
"idle_timeout": 5, //idle timeout in minutes
"idle_timeout_always_reload": true,
"reload_on_screen_on": true,
"theme": "Green", //must be "Blue" OR "Cyan" OR "Green" OR "Grey" OR "Orange" OR "Pink" OR "Purple" OR "Red" OR "Teal" OR "Yellow"
"colour_navigation_bar": false,
"lock_rotation": false,
"rotation": "Landscape", //must be "LANDSCAPE" OR "REVERSE LANDSCAPE" OR "PORTRAIT" OR "REVERSE PORTRAIT"
"fullscreen_mode": false,
"back_toggles_fullscreen": false,
"custom_screensaver": false,
"screensaver_timeout": 5 //idle time before screensaver starts in minutes
"custom_screensaver_type": "IMAGE", //must be "IMAGE" OR "VIDEO" OR "WEBSITE"
"screensaver_slide_delay": 15, //time between slides in seconds
"screensaver_random": false,
"screensaver_urls": "https://www.google.com,https://www.android.com",
"hide_action_bar": false, //hide toolbar
"display_toolbar_swipe_down": true, //displays toolbar on swipe down if hidden,
"custom_launcher_icon": false, //custom app icon
"icon_loads_home_page": true,
"show_browser_controls": true,
"show_home_icon": true,
"show_refresh_icon": true,
"show_back_icon": true,
"show_forward_icon": true,
"show_app_drawer_icon": false,
"show_bookmarks_icon": false,
"bookmarks": "https://www.google.com,https://www.android.com",
"bookmark_names": "Google,Android Website",
"bookmarks_title": "My Bookmarks",
"show_print_menu": false,
"custom_toolbar_url": "https://mywebsite.com",
"barcode_scanner": false,
"barcode_redirect_url": "https://www.mywebsite.com?barcoderesult=",
"camera_icon": false,
"show_restart_app_menu": false,
"hide_menu_items": false, //hides overflow menu items such as settings and exit
"page_zooming": true,
"overview_mode": true,
"use_wide_viewport": true,
"initial_zoom": 0, //value between 0-400
"user_agent": "DEFAULT" //must be "DEFAULT" OR "DESKTOP" OR "CUSTOM"
"user_agent_custom": "", //valid custom user agent string, user_agent must be set to CUSTOM
"timeout_cacheclear": true,
"timeout_storageclear": true,
"timeout_cookieclear": true,
"timeout_formsclear": true,
"autoplay_video": false,
"autoplay_audio": false,
"custom_error_page": false,
"redirect_custom_error_page": false,
"custom_denied_page": false,
"ignore_certificate_errors": false,
"cache_mode": "LOAD_DEFAULT", //must be "LOAD_DEFAULT" OR "LOAD_NO_CACHE" OR "LOAD_CACHE_ELSE_NETWORK" OR "LOAD_CACHE_ONLY"
"prevent_uploads": false,
"force_camera_uploads": false,
"keep_screen_on": true,
"prevent_screen_power_off": false,
"use_device_backbutton": true,
"nfc_enabled": false,
"control_wifi_state": false,
"wifi_enabled": true,
"volume_controls_enabled": true,
"default_camera": "FRONT", //must be "FRONT" OR "BACK"
"allow_bluetooth_devices": true,
"default_bluetooth_device": "00:00:00:00:00:00", //mac address of bluetooth device
"reload_network_change": true,
"reset_wifi": false,
"reset_wifi_interval": 0, //interval in minutes
"delay_load_on_startup": 30, //delay loading of page on startup in seconds
"url_whitelist": false,
"whitelist_deny_kiosk_url": false,
"whitelist_urls": "google.com,android.com",
"url_blacklist": false,
"blacklist_urls": "facebook.com",
"whitelist_redirect": false,
"whitelist_troubleshoot": false,
"enable_app_drawer": false,
"visible_apps": "com.google.android.calculator,com.google.android.calendar",
"wake_device": false, //scheduled wake
"device_wake_time": "07:00", //SUNDAY must be valid time string or empty string
"device_wake_time_monday": "", //must be valid time string or empty string
"device_wake_time_tuesday": "", //must be valid time string or empty string
"device_wake_time_wednesday": "", //must be valid time string or empty string
"device_wake_time_thursday": "", //must be valid time string or empty string
"device_wake_time_friday": "", //must be valid time string or empty string
"device_wake_time_saturday": ", //must be valid time string or empty string
"sleep_device": false, //schedule sleep
"device_sleep_time": "20:00", //SUNDAY must be valid time string or empty string
"device_sleep_time_monday": "", //must be valid time string or empty string
"device_sleep_time_tuesday": "", //must be valid time string or empty string
"device_sleep_time_wednesday": "", //must be valid time string or empty string
"device_sleep_time_thursday": "", //must be valid time string or empty string
"device_sleep_time_friday": "", //must be valid time string or empty string
"device_sleep_time_saturday": "", //must be valid time string or empty string
"app_restart": false,
"app_restart_time": "21:00", //must be valid time string
"always_wake_device": false,
"sleep_power_disconnect": false,
"sleep_power_connect": false,
"reboot_device": false, //schedule reboot
"device_reboot_time": "06:00", //SUNDAY must be valid time string or empty string
"device_reboot_time_monday": "", //must be valid time string or empty string
"device_reboot_time_tuesday": "", //must be valid time string or empty string
"device_reboot_time_wednesday": "", //must be valid time string or empty string
"device_reboot_time_thursday": "", //must be valid time string or empty string
"device_reboot_time_friday": "", //must be valid time string or empty string
"device_reboot_time_saturday": "", //must be valid time string or empty string
"show_reboot_device_menu": false,
"disable_safe_mode": false,
"disable_recents": true, //samsung knox only
"disable_svoice": true, //samsung knox only
"hide_status_bar": false, //samsung knox only
"hide_system_dialogs": true,
"aggressively_hide_system_dialogs": false,
"input_resize_page": false,
"input_resize_page_padding": 0,
"prevent_submit_keyboard": false,
"hide_progress_bar": false,
"require_password": true,
"multitap_settings": true,
"hardware_acceleration": true,
"javascript_interface": true,
"pause_javascript_timers_on_sleep": false,
"prevent_alert_dialogs": false,
"prevent_notification_access": true,
"barcode_scanner_timeout": 60, //timeout in seconds
"allow_intents": false,
"serial_number_source": "DEFAULT", //must be "DEFAULT" OR "RIL_SERIAL_NUMBER" OR RO_SERIAL_NUMBER" OR "SYS_SERIAL_NUMBER"
"hide_google_play_services_messages": false,
"allow_popup_windows": false,
"settings_password": "0000",
"wifi_settings_password":, "WiFiPassword",
"wifi_settings_enabled": false, //Show WiFi Settings Icon
"wifi_panel_enabled": false, //Show WiFi Panel Icon
"connectivity_panel_enabled": false, //Show Connectivity Panel Icon
"mobile_network_settings_enabled":false, //Show Mobile Network Settings Icon
"above_screen_lock": true,
"automatic_config_url": "https://www.myconfigurl.com/kbconfig.json",
"automatic_config_download_frequency": 18, //valid values between 15 and 1440 minutes
"webview_update_recovery": false
}
Updated on: 26/06/2025
Thank you!