WiFi toggle locked as "admin action" on Android 10 Newland devices despite Blueprint allowing WiFi

Android

If you're managing Newland devices running Android 10 and the WiFi toggle in Android Settings appears locked as an admin action, this article will help you resolve it. This issue does not affect Android 14 Newland devices or other Android versions.

Before you begin

Verify the following conditions before you attempt to fix this issue:

• Your device is a Newland device running Android 10
• Your Blueprint does not include any WiFi restriction rules
• WiFi is explicitly set to "allowed" in your active Blueprint

Step 1: Check your device OS version

1. In the Esper Console, navigate to Devices & Groups → [Device Name] → Device Info
2. Verify the OS version is Android 10. If your device runs Android 14, this issue does not apply

Step 2: Verify no WiFi restrictions are configured

1. Navigate to Devices & Groups → [Device Name] → Compliance Policy / Blueprint
2. Confirm that no WiFi restriction rules (such as "disable WiFi" or "lock WiFi toggle") exist at the device level or at the group level

Step 3: Re-apply your Blueprint

1. From the device detail page, navigate to Devices & Groups → [Device Name] → Blueprint
2. Select Apply Blueprint to force a policy re-push
3. Wait for the policy to sync to the device (typically 1–2 minutes)

Step 4: Verify the fix on your device

1. On the affected device, open Settings → WiFi
2. Check whether the WiFi toggle is now available and no longer shows an admin lock icon
3. Attempt to toggle WiFi on and off to confirm it responds to user input

Step 5: Use Esper Settings as a temporary workaround

If the native Android Settings WiFi toggle remains locked after re-applying the Blueprint, you can use the Esper Settings app as an interim workaround to enable or disable WiFi on the affected device. The Esper Settings app WiFi toggle functions correctly on these devices even when the Android Settings toggle is locked.

Step 6: Update the Esper agent when a fix is available

This issue is caused by a known compatibility issue in the Esper agent on Android 10 Newland devices. A fix has been released in an updated Esper agent version. To update:

1. Navigate to Devices & Groups → [Device Name] → Apps → Esper Agent
2. Select Update
3. Wait for the update to complete (the device will reboot if required)
4. After the update, verify that the WiFi toggle in Android Settings is no longer locked

Still need help?

If the WiFi toggle remains locked after re-applying the Blueprint and updating the Esper agent, or if you encounter this issue on non-Newland devices or Android versions other than 10 contact Esper Support. Include your device model, Android version, Esper agent version, and the serial numbers of all affected devices.