New PWA install interface on Android

Starting on Chrome 90, Discourse admins can add screenshots to the PWA install bottom sheet.

You will need to take a few screenshots of interesting pages, upload those a topic and fill then in at /admin/site_settings/category/branding?filter=manifest screenshots.

For the screenshots, Chrome documents the following requirements:

  • Width and height must be at least 320px and at most 3840px.
  • The maximum dimension can’t be twice larger than the minimum dimension.
  • Screenshots must have the same aspect ratio.
  • Only JPEG and PNG image formats are supported.

After filling the setting, it will look like this:

If you have a login required site, be aware that the screenshots are public.


According to Techdows, the new PWA install interface will be brought to desktop platforms too: Chrome for Android to get bottom sheet UI for PWA installs

Once the new PWA install interface becomes available on desktop platforms, will Discourse support it too?

Yes, it will be automatically supported as we implement according to the spec, and as browsers catch up the feature is already there. That’s similar to Inviting users from your contact list where we implemented the spec in January 2020, Android users got it with Chrome 80 in Feb 2020 and iOS users will maybe get it with iOS 14.5 in 2021.

1 Like

I anticipate to see the feature on my iOS devices by the end of March then. :smile:

I assume that the feature will also be supported in Microsoft Edge and other Chromium browsers. Great stuff!

As for the integration with contact lists, I hope to see it available on desktop platforms too.


How to fill in the settings for the screenshots? Seems only to be a text field and does not prompt for an image upload.

You need to upload to a topic, copy the URL afterwards and use that in the site setting.


Nice, but what about if we do not want the PWA?

We have many users with androids who get confused and do no like the option…
Most of the admins use IOS and so were a bit lost trying to figure out what was their concern, I have a BB so wasn’t concerned either…

For security reasons, we instructed that “There should never be any message to “download an app” from this site” on our forum and if it were a minor concern, affecting IOS will affect us seriously

Will the admins have the choice in enabling or not the PWA interface? if not how can we disable the PWA install feature?

I have added a couple of screenshots links in the manifest screenshots, in order to test these features. But it’s not working for me. I have tried chrome v90.0.4430 and chrome canary 91.0.4446. Is this feature ready to implement or do we have to wait??

Try informing your users about PWAs.

1 Like

You have to enable a flag in Chrome Canary to test it:


You can hide the banner that prompts users to install it with CSS.


Thank you
I will clarify a bit, we have nothing against PWA, it might be the way to go, but not having an invasive pop-up when they join the site, asking them about PWA and installing it. It’s too invasive and not at all in the spirit of our group, we already lost folk migrating to discourse, those happy with no GUI etc…

Thank you,
Will give a try and see if it solves…
As I will need to find a monkey to test after, me with my BB see nothing (at all hahaha specially now it is been by Google as iOS (???)…)

Oh yeah, there’s probably a way to only just hide the pop-up. I think that would be a much better solution rather than disabling the functionality altogether.

BlackBerry is out of touch with the modern world. From what I remember when I owned one, even Windows Phone/Windows 10 Mobile supported PWAs! :laughing:

1 Like

It’s working fine for meta and not for my site in chrome canary. I have uploaded the image and added the links in manifest screenshots. Is there anything I am missing here?

1 Like

Can you link the site here? I can take a look at it for you!

1 Like

Thanks, there is a mod in UK that will have a look…

The idea of disabling the PWA, was not to remove, but more when we have more time see how we can integrate the PWA, compatible with our thoughts, not as a popup perhaps a link to for those wanting to try…

There is no pop-up.

The install prompt for PWA install in Discourse that happens in Android is a link in a top banner that only happens for users with enough engagement.

The new screenshots mentioned above only show after the user clicks on the prompt we have used for years.


I appreciate, will have a look straight away

Thanks bro,

Here is my site,

1 Like