A web app manifest is a JSON file, usually manifest.webmanifest, that describes a web application to the browser. It supplies the name, icons, start URL, theme color and display mode that the browser uses when a user installs the site to a home screen or desktop.
Why it matters
The manifest is one of the requirements for a site to be installable as a progressive web app, together with HTTPS and, in some browsers, a registered service worker. It controls the installed experience: the icon, the splash screen and whether the app opens in a standalone window without browser controls.
Example
<link rel="manifest" href="/manifest.webmanifest">
{
"name": "Status Board",
"short_name": "Status",
"start_url": "/?source=pwa",
"display": "standalone",
"background_color": "#ffffff",
"theme_color": "#0a66c2",
"icons": [
{ "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
{ "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
]
}
Common mistakes
- Missing the 192 and 512 pixel icons, so the install prompt never appears.
- A
start_urlthat redirects or requires login, which can break launch. - Serving the file with the wrong status code or blocking it behind authentication.
Related
Get notified when this term updates
Plus occasional practical tips on uptime and monitoring, nothing else. Unsubscribe anytime.
This page is general information written by our editorial team and updated when documentation changes. Servers and providers differ, so test changes safely first. See our editorial policy and disclaimer.