Table of Contents
Overview
Your White Label portal can be offered to your customers as a Progressive Web App (PWA). Once you enable it, your customers can install your branded portal directly from a supported browser and open it from a dedicated icon on their desktop, taskbar, dock, or home screen, without an app store download.
The PWA is not a separate product. It gives your customers a faster, app-like way to access the same portal, with the same accounts, the same subscriptions, and the same functionality. An internet connection is always required.
You enable and configure the PWA for your site from the yconsole.
Requirements
To make your portal installable as a PWA, you need both of the following:
- A valid PWA icon. Browsers require a real square icon of at least 192 x 192 px to allow installation. The recommended specification is a 512 x 512 px, square, PNG file. Logos that are too small or non-square do not qualify. If no valid icon is set, your site stays branded but cannot be installed as an app.
- The Enable PWA switch turned on. This is the master switch for installing your site as a Progressive Web App. When it is off, the manifest and service worker are not served, so the site cannot be installed as an app even if a PWA icon is set.
Enabling the PWA in yconsole
- Log in to yconsole.
- Navigate to Partners and click Site.
- Click your site’s domain name to open its settings.
- In the Pwa icon field, click Choose File and upload your app icon. This is the icon your customers see when they install your portal on their device. Use a 512 x 512 px square PNG.
- Check the Enable PWA box.
- Click Save.
Once saved, supported browsers detect that your site can be installed and start offering the install option to your customers.
What Your Customers See
After you enable the PWA, your customers can install your portal from any supported browser:
- Desktop Chrome and Edge: an install icon appears in the address bar, or the option is available from the browser menu. Installation creates a desktop shortcut and an entry in the operating system’s app list, and the portal opens in its own standalone window. Firefox does not support PWA installation on desktop.
- Android: Chrome and Edge offer Install and create shortcut (or Add to Home screen / Install app, depending on the version) from the browser menu. Samsung Internet offers a download icon in the address bar. Firefox offers Add app to Home screen from its menu.
- iPhone and iPad: In Safari, customers use Share and then Add to Home Screen.
In all cases, the installed app uses your branding and your PWA icon, and your customers log in with their existing portal accounts.
⚠️Note: on Android with Samsung Internet, Google Play Protect may show a warning during installation. This is standard Android behavior for apps installed outside the Google Play Store and relates to how Samsung Internet packages web apps. It does not indicate an issue with your portal. Customers can proceed by tapping More details and then Install anyway.
Troubleshooting
| Symptom | Possible cause | Fix |
|---|---|---|
| No install option appears for the site | The Enable PWA switch is off, so the manifest and service worker are not served | Turn on Enable PWA in the yconsole and save. |
| Enable PWA is on but the site still cannot be installed | The PWA icon is missing, too small or non-square | Upload a real square PNG icon of at least 192 x 192 px (512 x 512 px recommended) in the Pwa icon field. |
| A single customer cannot install while others can | The customer’s browser or device does not support PWA installation, or the browser is outdated | Ask the customer to use an updated version of Chrome or Edge and check the browser menu for Install app, Add to Home Screen or Create shortcut. Remind them that Firefox does not support installation on desktop. |
| The installed app does not load for a customer | Network issue, expired session or local browser data problem on the customer’s device | Ask the customer to open your portal URL directly in the browser. If the browser version works but the installed app does not, the customer should clear browser data or reinstall the PWA. |
Frequently Asked Questions
Does the PWA require a separate app or app store listing?
No. Customers install the portal directly from a supported browser. There is no app store submission or review process involved.
Do my customers need new accounts?
No. They log in with their existing portal accounts. The PWA is only a different way to open the same portal.
Does the installed app work offline?
No. The portal requires an internet connection, whether opened in a browser or as an installed app.
Why can’t my customers install the portal?
Check that the Enable PWA switch is on and that a valid square PNG icon of at least 192 x 192 px is uploaded in the yconsole. If either is missing, browsers do not offer the install option. Also, confirm the customer is using a supported, updated browser such as Chrome or Edge.