> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.android-kiosk.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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.**

**To create a JSON file you can either export the configuration from an existing device (as explained above) or use our builder tool.**
https://www.android-kiosk.com/kbconfigbuilder.htm

![](https://storage.crisp.chat/users/helpdesk/website/-/f/8/9/1/f891df320cad6800/image_12ejr6z.png)



||| Please note that some fields require specific strings as detailed in the comments (comments must not be included in the final json as it does not support comments). 

|| It's possible to clear a string property by just using an empty string "". Null can be applied to all of the sleep/wake/restart times


### 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,
        "default_launcher_check": false
}
```