Skip to main content

Additional JSON Settings

This feature is available for: ✓ Templates ✓ Blueprints

This page is a knowledge base for additional configurable settings via JSON. These settings are not available in the console or Esper settings app on the device. Adding JSON can be done through a blueprint's Esper Settings > Advanced Settings section or in a template's Settings > Extra settings for Android section.

This is one way of setting JSON configs. If you were looking to set JSON configs for apps, see app-level manage configurations.

In this article: 

JSON Setting Requirements

Device setting availability varies widely among Android versions and manufacturers. You can use the adb commands to determine the list of settings available on your device. 

adb shell settings list system
adb shell settings list global
adb shell settings list secure

You can also test these settings directly using the following command: 

adb shell settings put {system/global/secure} {key} {value}

Learn more about testing advanced Android configurations in our blog article.

Advanced JSON Settings

Name Description JSON Supervisor plugin Comments

Sound Notification

 Set notification sound file to “None” 

{
    "settings": {
        "system": [
            {
                "key": "notification_sound",
                "value": null
            }
        ]
    }
}
No N/A

Accessibility Shortcut

 Disable accessibility shortcut for TalkBack. Ensure TalkBack itself is disabled. 

{
    "settings": {
        "secure": [
            {
                "key": "accessibility_shortcut_enabled",
                "value": "0"
            },
            {
                "key": "enabled_accessibility_services",
                "value": null
            }
        ]
    }
}
Yes N/A

Lock Screen Notifications

 Disable all notifications on the lock screen 

{  
    "settings": {
        "secure": [   
            {
                "key": "lock_screen_show_notifications",
                "value": "0"
            },    
            {  
                "key": "lock_screen_show_silent_notifications", 
                "value": "0" 
            } 
        ]
    } 
}
Yes N/A

Airplane Mode

 Enable Airplane Mode in order to disable Wi-Fi and allow usage of an ethernet adapter. 

{
    "settings": {
        "global": [
            {
                "key": "airplane_mode_on",
                "value": "1"
            }
        ]
    }
}
Yes Reboot the device to take effect.

Software Keyboard

 Shows the software keyboard when a physical keyboard is plugged in 

{
    "settings": {
        "secure": [
            {
                "key": "show_ime_with_hard_keyboard",
                "value": "1"
            }
        ]
    }
}
Yes N/A

Display Size

 Display size or scaling 

{
    "settings": {
        "secure": [
            {
                "key": "display_density_forced",
                "value": "240"
            }
        ]
    }
}
Yes N/A

Navigation Bar in Kiosk Mode

 Hides the navigation bar at the bottom of the screen when in kiosk mode 

{
  "dpcParams": [
    {
      "key": "hideNavBarInKioskMode",
      "value": "true"
    }
  ]
}
No Only on Esper Foundation 

Font Scale

 Set font size as large as 1.15 or as small as 0.9 

{
    "settings": {
        "system": [
            {
                "key": "font_scale",
                "value": "1.15"
            }
        ]
    }
}
No N/A

Clock

 Sets the clock to 12 hrs format. 

{
    "settings": {
        "system": [
            {
                "key": "time_12_24",
                "value": "12"
            }
        ]
    }
}
No N/A

Data Roaming

 Enable roaming data usage. 

{
    "settings": {
      "global": [
        {
          "key": "data_roaming",
          "value": "1"
        }
      ]
    }
  }
Yes Bluebird HF550 devices have special integration.

APN Configuration

 APN config 

{
  "dpcParams": [
    {
      "key": "addNewApnAndSetDefault",
      "value": "{\"name\":\"name\",\"apn\":\"super\",\"proxy\":\"\",\"port\":\"\",\"mmsproxy\":\"\",\"mmsport\":\"\",\"user\":\"\",\"server\":\"\",\"password\":\"\",\"mmsc\":\"\",\"authtype\":\"-1\",\"protocol\":\"IPV4V6\",\"roaming_protocol\":\"IPV4V6\",\"type\":\"default\",\"mcc\":\"carrier-specific\",\"mnc\":\"carrier-specific\",\"numeric\":\"mcc+mnc\",\"current\":\"1\",\"bearer\":\"0\",\"carrier_enabled\":\"1\"}"
    }
  ]
}
Yes or Samsung Knox  "Requires a reboot after the Knox agreement. For SM-T547U and AT&T M2X IoT data service". Learn more about APN setup. 

Lock Screen

 Disable lock screen phone shortcut 


{
    "dpcParams": [
        {
            "key": "hideLockscreenShortcuts",
            "value": "true"
        }
    ]
}
No (Samsung Knox required) Samsung only

Screen Shortcut

 Disable Samsung Edge Screen shortcut 

{
    "dpcParams": [
        {
            "key": "allowEdgeScreen",
            "value": "false"
        }
    ]
}
No (Samsung Knox required) Samsung only

Run App on Button Press

 Application to run on a particular button press 

{
  "button_left": "Run application",
  "button_left_run_application": "com.android.camera2"
}
No N/A

Enable Battery Saver

 Enable low power/battery saver mode.  

{
    "settings": {
        "global": [
            {
                "key": "low_power",
                "value": "1"
            }
        ]
    }
}
Yes N/A

Disable Lenovo OneVision Widget

 Disable Lenovo's OneVision Widget.  
{
    "settings": {
        "secure": [
            {
                "key": "show_ov_top_bar",
                "value": "0"
            }
        ]
    }
}
 Yes Lenovo only

Always on VPN App

 Enable your VPN app at the time of provisioning.  
{
    "settings": {
        "secure": [
            {
                "key": "always_on_vpn_app",
                "value": "com.your-vpn.packagename"
            }
        ]
    },
    "managedAppConfigurations": {
        "com.your-vpn.packagename": {
            "key1": "value1",
            "key2": "value2",
            "key3": "value3"
      
        }
    }
}
 Yes Managed app configurations are available for some VPNs. Learn more about Play Store-hosted and non-Play store-hosted managed app configurations.

Related articles

Featured content