Web App Creation Fails Due to Invalid URL Format (`https://https://`) — Icon Upload Is Optional

Android

If you're unable to create a web app in the Esper Console, the issue may be a malformed URL with a duplicate https:// prefix. This article explains how to fix this error and clarifies that icon uploads are optional when creating web apps.

Before you begin

Web app creation fails when the URL field contains a double scheme prefix, such as https://https://learning.reimaginedparking.com/#/public-dashboard. This is a common copy-paste error that occurs when you manually prepend https:// to a URL that already includes the scheme.

Icon uploads are optional — you do not need to provide a custom icon. Esper automatically assigns a default icon if you leave the Icon field blank.

How to fix the malformed URL

1. In the Esper Console, go to Apps → Web Apps → Add Web App (or edit your existing web app entry).
2. In the URL field, inspect the value and remove any duplicate https:// prefix. The URL should start with only one https://.
   • ❌ Incorrect: https://https://learning.reimaginedparking.com/#/public-dashboard
   • ✅ Correct: https://learning.reimaginedparking.com/#/public-dashboard
3. Leave the Icon field blank if you do not have a custom icon. A default icon will be assigned automatically.
4. Complete the remaining fields (App Name, and any others) and click Save or Create.
5. Verify that the web app appears in your Apps list without errors and can be added to a Blueprint or pushed to a device group.

How to verify the web app works on your device

Once the web app is created, install it on a test device and confirm that the shortcut launches the correct URL without errors.

If the web app installs but does not open correctly on the device:

• Verify that the device has network access to the target URL.
• Confirm that the URL does not require authentication or rely on session state or cookies that are unavailable at launch.

About icon uploads

Icon upload is optional by design. You do not need to source or create a custom icon asset to use web apps. If you leave the Icon field blank, Esper automatically assigns a default icon to your web app.

Still need help?

If you've corrected the URL format and the web app still fails to save, or if the Icon field appears to be required (blocking form submission), contact Esper Support.