/tools/pwa-icon-generator

PWA Icon Generator

Make the icon set a progressive web app needs to be installed, including a maskable icon that survives circle and rounded-square masks, plus the icons array for your web app manifest.

Private & secure
Upload image or drag & drop
PNG · JPG · SVG · → PNG

How to use the PWA Icon Generator

01
Upload
Use a square logo, ideally 512 px or larger.
02
Adjust
Set padding, corner radius and background.
03
Download
Get every size plus the code for your site.

Icons a web app manifest needs

Browsers that install web apps read the icons listed in the manifest. Chromium-based browsers look for at least a 192 pixel and a 512 pixel icon, used for the home screen, app launcher and splash screen. The zip includes icon-192.png and icon-512.png for those, plus apple-touch-icon.png at 180 × 180, because Safari has long used the apple-touch-icon link for home screen icons.

What a maskable icon is

Android displays app icons in whatever shape the device uses, such as a circle, squircle or rounded square, by cropping the image. A regular icon can lose its edges in the process. A maskable icon is designed for this: its important content sits inside a central safe zone, a circle whose diameter is 80% of the icon, and the rest is filled with background.

maskable-512.png is built that way. It adds an extra 10% of padding per side on top of your padding setting, skips the corner radius because the device applies its own mask, and fills the background with your chosen color or white. In the manifest it is listed separately with purpose set to maskable, so devices that don't mask icons use the regular ones.

Adding the icons to your app

Copy the PNGs to the root of your site; the paths in manifest-icons.json point to /icon-192.png and so on, so edit them if you use a different folder. Merge the icons array into your manifest alongside name, short_name, start_url and display, and link the manifest from your HTML. The same array is shown on the page with a Copy button. After deploying, the Application panel of the browser developer tools lists the icons it found in the manifest.

Supported formats

PNGJPGSVG→ PNG

Files up to 25 MB. Large, high-resolution photos are supported.

Privacy

Your file is sent over HTTPS, processed in memory and returned straight away. It is never stored, never shared and never used for anything else. No account needed. How we handle files.

PWA Icon Generator FAQ

Why does the maskable icon look smaller inside?

The extra padding keeps your artwork inside the safe zone, so no device mask can cut it off.

Can I use my regular icon as the maskable one?

You can, but devices will crop it into their shape and may cut off the edges. A dedicated maskable icon avoids that.

Where do I put the files?

In the root of your site, matching the paths in the manifest snippet, or in another folder with the paths updated.

Does it generate the whole manifest?

No. It provides the icons array. You still add name, short_name, start_url, display and colors yourself.

Why doesn't my app offer to install?

Icons are only one requirement. Browsers also expect HTTPS and a valid manifest, and some look for a service worker.

Are my images safe?

Your file is sent over HTTPS, processed in memory and returned straight away. It is never stored, never shared and never used for anything else.

Is it free?

Yes. No account, no watermark and no limit on how many images you process. Files can be up to 25 MB.

Related tools

See all 8 utilities tools →