lowPerformance

PWA Manifest Missing Required Fields

The PWA manifest is missing required fields: name (or short_name) and start_url, preventing install prompts on mobile browsers.

By Seoxpert Editorial · Published May 2, 2026

Why it matters

Without the required manifest fields, users won't see the 'Add to Home Screen' prompt on Android browsers, reducing engagement and repeat visits. This also impacts the app-like experience and can hurt your site's perceived quality and discoverability.

Impact

Users cannot install your site as a PWA, missing out on app-like engagement and visibility.

How it's detected

Automated crawlers fetch the manifest file and check for the presence of required fields like name (or short_name) and start_url.

Common causes

Manifest file was generated with minimal or outdated tools
Manual edits omitted required fields
Copy-pasting templates without customizing required keys
Misunderstanding of which fields are mandatory

How to fix it

Edit your manifest.json (or site.webmanifest) to include at least the 'name' (or 'short_name') and 'start_url' fields. Ensure you also provide at least one icon (192x192) and set 'display' to 'standalone' for best results. Example: {"name":"Your App","short_name":"App","start_url":"/","display":"standalone","icons":[{"src":"/icon-192.png","sizes":"192x192","type":"image/png"}]}

Code examples

Problematic manifest (missing required fields)

{
  "display": "standalone",
  "icons": [
    {"src": "/icon-192.png", "sizes": "192x192", "type": "image/png"}
  ]
}

Fixed manifest (includes required fields)

{
  "name": "Your App",
  "short_name": "App",
  "start_url": "/",
  "display": "standalone",
  "icons": [
    {"src": "/icon-192.png", "sizes": "192x192", "type": "image/png"}
  ]
}

FAQ

What happens if my PWA manifest is missing name or start_url?

Mobile browsers will not prompt users to install your PWA, and the site cannot be added to the home screen as an app.

Is short_name required if I have name in my manifest?

Either name or short_name is required, but including both is recommended for best compatibility.

Does this affect iOS devices?

iOS is more forgiving, but still uses the manifest for launch icon and theme color, so missing fields can affect the user experience.

How can I test if my manifest is valid?

Use Chrome DevTools' Application tab or online manifest validators to check for missing required fields.

Found this issue on your site?

Run a scan to see if PWA Manifest Missing Required Fields affects your pages.

Scan my website →