Skip to main content
Progressify > Settings > Web App Manifest The manifest is the JSON file a browser reads to decide whether your site can be installed and what the installed app should look like. Progressify generates it from this tab. Everything here ends up in that file, so changes take effect on the next install, and already-installed apps pick most of them up when the browser refreshes the manifest.

App identity

image
required
The source image for every icon Progressify produces: home screen icons at each required size, a maskable icon for Android’s adaptive shapes, splash screens, and the install QR code. Use a square PNG of at least 512 by 512 pixels. Defaults to your WordPress site icon when one is set.
string
required
The full name, shown on the install prompt and in app listings. Defaults to your site title.
string
A shorter name for places where the full one will not fit, most visibly the label under the home screen icon. Limited to 30 characters. Aim for 12 or fewer to avoid truncation on Android.
string
A short summary of what the app does. Appears on the install page and in some app listings. Defaults to your site tagline.
images
Pro. Up to five screenshots shown on richer install dialogs and on your install page. Progressify auto-generates one mobile and one desktop shot of your homepage, so this is only worth setting if you want to show specific screens.
multi-select
Pro. Hints for catalogs and store listings. Choose no more than three from: books, business, education, entertainment, finance, fitness, food, games, government, health, kids, lifestyle, magazines, medical, music, navigation, news, personalization, photo, politics, productivity, security, shopping, social, sports, travel, utilities, weather.
toggle
default:"off"
Pro. Makes each page individually installable by building the manifest from the page being viewed rather than from the settings on this tab. The homepage always uses the values above.Leave this off unless you specifically want different app identities per page. Turning it on means a visitor who installs from a blog post gets an app named after that post.

Display settings

string
default:"/"
The path the app opens on when launched from the home screen. Use a root-relative path. Leave it at / unless you have a dedicated app landing page.

Display mode

select
default:"standalone"
Choose minimal-ui if your site has deep navigation and visitors will miss the back button. standalone relies on your own in-app navigation, so pair it with the navigation tab bar or swipe navigation.
select
default:"portrait"
portrait, landscape, or any. This is a preference, not a guarantee, and some platforms ignore it.
toggle
default:"off"
Pro. Actively prevents rotation rather than merely expressing a preference.

Appearance

color
default:"#000000"
Tints the title bar of the installed app and the browser toolbar on mobile. Set it to your brand color.
color
default:"#ffffff"
The color shown on the splash screen while the app boots, before your CSS loads. Match it to your site’s page background so the transition is invisible. Progressify also uses it when generating splash screens.
select
default:"default"
Pro. iOS only.black-translucent needs your layout to account for the area behind the bar, or your header will sit under the clock.

Advanced features

repeater
Pro. Tasks reachable from a long press on the app icon on Android, or a right click on the taskbar or dock icon on desktop. Each entry takes an icon, a name, and a path.Good candidates are destinations people go to repeatedly and directly: an account page, a search page, a cart. Most platforms display no more than four.
Pro. Lists native apps that correspond to this site, for the Play Store, the App Store, or Microsoft Store. Each entry is a platform and an app ID.
Listing a related application tells the browser to promote the native app instead of the PWA. Only fill this in if you actually want visitors sent to a store rather than installing the web app.
string
Pro. An International Age Rating Coalition certificate number, used by some catalogs to classify the app’s age suitability. Leave empty unless you have one.

Checking the generated manifest

Progressify serves the manifest from a query variable on your home URL rather than from a static file:
Open it directly to see the JSON your settings produce. For the browser’s own view, open developer tools and go to Application > Manifest. That panel shows which icons the browser actually resolved and flags anything it considers invalid, which is the fastest way to diagnose an install prompt that never appears.