Course contentsShow
← Web Development
Lesson 2239 of 2,98240. Browser DevTools Deep DiveFree lesson

Web App Manifest Validation

Inspect manifest.json properties, validate icons and display modes, and test install criteria for Progressive Web Apps.

Web App Manifest Validation

What you'll learn: How to use the Application panel to validate your manifest.json file and ensure your Progressive Web App meets installation criteria.


The Web App Manifest (manifest.json) is the configuration file that tells browsers how to treat your site as an installable app. When a user adds your PWA to their home screen, the browser relies on this manifest to determine the app's name, icon, display mode, and more. Just as you wouldn't launch a product with a broken label, you shouldn't deploy a PWA with an invalid manifest.

Inspecting Manifest Properties in DevTools

In the Application panel, navigate to the Manifest section. Chrome DevTools displays all detected properties from your manifest.json, including:

  • name and short_name (app titles)
  • start_url (launch URL)
  • display mode (standalone, fullscreen, minimal-ui, or browser)
  • theme_color and background_color
  • icons array

Any missing required fields or malformed values appear with warnings or errors. If your manifest file fails to load entirely, DevTools shows why—perhaps a typo in your <link rel="manifest"> or invalid JSON syntax.

Validating Icons and Display Modes

The icons section deserves special attention. DevTools previews each icon size and alerts you if:

  • Required sizes are missing (typically 192×192 and 512×512)
  • Image paths return 404 errors
  • Icons lack proper purpose values (like "maskable" for adaptive icons)

The display mode preview shows how your app will appear when launched from the home screen—without browser chrome in standalone mode, for example.

Testing Install Criteria

At the bottom of the Manifest section, DevTools lists installability criteria. For a PWA to be installable, it must meet conditions like having a valid manifest, serving over HTTPS, and registering a service worker. Any unmet requirements are highlighted, giving you a clear checklist before deployment.

Key Takeaway: Use the Application panel's Manifest section to validate all properties, preview icons and display modes, and confirm your PWA meets browser installation criteria before users arrive.