b2KIT

Manifest.json Validator

Validate PWA manifest.json files for required fields, icon sizes, and Web App Manifest specification compliance.

Tested tool guide Tested browser tools Checked August 16, 2026

What Manifest.json Validator does and how it behaves

Manifest.json Validator examines a Web App Manifest and reports whether it is valid JSON and whether its members, required values, and declared icons satisfy the validator's manifest checks. It is useful before linking a manifest from an HTML page or while investigating installation problems. The frequent surprise is that valid JSON is only the first gate: a document can parse cleanly while still containing missing fields, incorrect value types, unusable URLs, or icon declarations that do not meet the expected rules.

How the result is produced

1

JSON and manifest checks

The validation has two distinct questions. First, the submission must be a JSON object, so quoted names, commas, arrays, and value types must follow JSON syntax. After parsing, the manifest-specific pass can examine recognized members and the validator's required-field expectations. If parsing fails, checks involving name, start_url, display, icons, and their value types cannot be meaningfully completed.

2

Icon descriptor checks

An icons member is an array of image resource objects. Within each entry, src names the resource, sizes is a string containing dimension tokens such as 192x192 or the keyword any, and type can identify the media type. The validator can assess those declarations for its icon-size rules, but a well-formed descriptor should not be confused with proof that the deployed image is reachable and correct.

Good uses

  • Before shipping a new PWA, paste the candidate manifest to catch malformed JSON, omitted values the validator expects, and icon size declarations that do not satisfy its checks.
  • When a browser's application panel flags a manifest, use this validator to isolate document-level field and icon problems before investigating page linkage, caching, or runtime installation behavior.
  • After changing app names, start paths, display mode, or icon assets, recheck the final manifest text for stale members, wrong JSON value types, and inconsistent icon descriptors.

Limits and checks

  • A JavaScript object literal is not automatically valid manifest JSON. Comments, trailing commas, single-quoted strings, undefined values, and executable expressions are outside JSON syntax, even if similar text works inside source code.
  • The word required can be misleading. Some members are optional or have fallbacks in the Web Application Manifest specification, while a validator may require a practical baseline for its compliance check. Consult the specification before describing a flagged member as universally mandatory.
  • Successful structural validation cannot establish that relative URLs point to the right resources after deployment. Values such as start_url, scope, and icon src are resolved in relation to the manifest's served URL; moving the manifest can change their targets without changing its JSON text.

Common questions

Does a clean result mean browsers will offer installation?

No. The result concerns the manifest text and the checks reported for it. Installation also depends on how the page links the manifest, whether referenced URLs work from the served manifest's location, the security context, browser policy, and other application conditions. Test the deployed site in each target browser after fixing the document-level findings.

Why can an icons entry fail even when the image opens directly?

Manifest icon sizes are declarations, not image dimensions discovered from the JSON alone. The sizes value is a JSON string, even when it contains several tokens; it is not an array of numbers. Use tokens such as 192x192 or 512x512, separated by spaces when appropriate, or any for a scalable resource. Each icon also needs a string src value.

References and verification

The behavioral notes were checked against the browser implementation. Standards and primary references below define the relevant format, formula, or platform behavior.

Related Tools