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:
nameandshort_name(app titles)start_url(launch URL)displaymode (standalone,fullscreen,minimal-ui, orbrowser)theme_colorandbackground_coloriconsarray
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
purposevalues (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.