Adjusting device text/font size: custom JSON via Blueprint or granting end-user access to Android Settings

Android

You can adjust text and font size on your Esper-managed Android devices in two ways: remotely through a Blueprint configuration, or by temporarily allowing end users to change it themselves through Android Settings.

Before you begin

The exact location of font size settings on your device may vary depending on your Android version and device manufacturer. Common paths include Settings → Display → Display size and text or Settings → Accessibility → Font size.

How to set font size remotely via Blueprint (recommended)

This method lets you control font size across one or more devices from the Esper Console.

1. In the Esper Console, go to Blueprints and open or create a Blueprint applied to your target device(s).
2. Navigate to Esper Settings → Advanced Android Settings.
3. In the custom JSON field, enter the following configuration:

   {
    "settings": {
    "system": [
    {
    "key": "font_scale",
    "value": "1.0"
    }
    ]
    }
   }

4. Adjust the "value" to your desired font scale. Supported increments are:
   • 1.0 — default
   • 1.2 — slightly larger
   • 1.4 — larger
   • 1.6 — large
   • 1.8 — extra large
   • 2.0 — maximum
5. Click Save and Publish the Blueprint.
6. Go to Devices & Groups, select your target device(s), and converge the Blueprint to them.
7. On the device, open Settings → Display and verify that the font scale matches the value you set. You should see the system text size change visually.

How to allow end users to change font size themselves

This method gives end users (such as drivers) temporary access to adjust font size through Android Settings on their device.

1. In the Esper Console, go to Blueprints and open the Blueprint applied to the target device.
2. Click Edit.
3. Go to Esper Software Updates.
4. Turn on the toggle to enable Android Settings access.
5. Click Save and Publish the Blueprint, then converge it to the device.
6. Instruct the end user to navigate on their device to Settings → Display → Display size and text (or search for "font" in Settings if the path differs) and adjust the font size as needed.
7. Once changes are complete, return to the Blueprint and turn off the Android Settings toggle to re-lock the device.
8. Click Save and Publish, then converge the Blueprint again to confirm the device is locked down.

Troubleshooting

The custom JSON did not apply after convergence:

• Verify that the Blueprint converge completed successfully. In Devices & Groups, check that the device shows a Compliant status.
• Ensure your Esper Agent is up to date. Update it if an older version is installed on the device.

End users cannot find the font size setting:

• The setting location varies by device manufacturer and Android version. Have users search for "font" or "text size" in Android Settings to locate it quickly.

Font size settings revert after Blueprint convergence:

• This is expected behavior. If you want to preserve a specific font size, use the Blueprint custom JSON method (Option A) instead, as manual changes will be overwritten when the Blueprint reconverges.

Still need help?

If you continue to experience issues, contact Esper Support and include the following details:

• Your device model and Android version
• The font scale value you attempted to set
• Whether you used the Blueprint custom JSON method or the Android Settings method
• Your device's current compliance status in the Esper Console