Wi-Fi settings blocked on enrolled devices: disable `disableWifiMode` Esper Agent param in Blueprint Advanced Android Settings

Android

If you're unable to access Wi-Fi settings on your Esper-enrolled devices, a Esper Agent parameter in your Blueprint's Advanced Android Settings may be blocking Wi-Fi access. This article explains how to identify and fix the issue.

Understanding the problem

When the disableWifiMode parameter is set to true in your Blueprint's Advanced Android Settings, users cannot access or toggle Wi-Fi through the device's native Settings app. This is an intentional lockdown feature designed for kiosk deployments, but if enabled unintentionally, it blocks all Wi-Fi management without displaying an error message.

How to disable Wi-Fi restrictions

1. In the Esper Console, go to Blueprints and open the affected Blueprint.
2. Navigate to the Android Settings section.
3. Locate the Custom Esper Agent Parameters or Advanced JSON configuration block.
4. Find and remove or modify this entry:

   { "key": "disableWifiMode", "value": "true" }

   Either delete the entry entirely or change "value" to "false".

5. Save the updated Blueprint.
6. Apply the updated Blueprint to your devices. Go to Devices & Groups, select your target device or group, then select Blueprint → Converge.
7. On the affected device, verify the fix by opening Settings → Network & Internet → Wi-Fi and confirming the toggle is accessible.

If converging the Blueprint doesn't work

Blueprint convergence may not retroactively remove Esper Agent restrictions on devices that were already enrolled. If Wi-Fi access is still blocked after applying the updated Blueprint, try one of these approaches:

• Re-provision the affected devices using the corrected Blueprint via QR code, Zero-Touch, or KME.
• Factory reset and re-enroll the device with the updated Blueprint if re-provisioning is not available.
• Check for group or parent Blueprints that may also have the disableWifiMode parameter set. Remove it from all applicable Blueprints, as child or group-level configurations can override your device-level settings.
• Verify Android Enterprise restrictions are not also blocking Wi-Fi. Check your Blueprint for user restrictions like DISALLOW_CONFIG_WIFI, which operate independently of Esper Agent parameters.

Still need help?

If you've removed the disableWifiMode parameter and re-provisioned your devices but Wi-Fi access is still blocked, contact Esper Support. Provide details about your Blueprint configuration, the devices affected, and the steps you've already taken.