JSON schemas for Chrome extension manifest files (V2 and V3) with support for Node.js

chrome-extension-manifest-json-schema

JSON schemas for Chrome extension manifest files. For info about JSON schemas, see json-schema.org.

What's included?

• V3 - the current target. Tracks the modern Manifest V3 surface, including action, background.service_worker, host_permissions/optional_host_permissions, the object form of web_accessible_resources and content_security_policy, declarative_net_request, side_panel, cross_origin_embedder_policy/cross_origin_opener_policy, and the world / match_origin_as_fallback content-script keys.
• V2 - Manifest V2, kept for archival validation only. Chrome removed Manifest V2 support entirely in Chrome 139 (mid-2025); new extensions must use V3.

This is an independently maintained schema that follows the official Chrome manifest reference. The community SchemaStore schema is a related project; this package aims to stay current with newer Chrome fields and is consumable directly from Node.js.

Install

npm install chrome-extension-manifest-json-schema

Usage

You can either point to V3 or V2 schemas or get it by the Node.js interface.

const {manifestV2Schema, manifestV3Schema} = require('chrome-extension-manifest-json-schema')

console.log(manifestV3Schema)

Outputs:

{
  "title": "JSON schema for Google Chrome extension manifest files",
  "$schema": "http://json-schema.org/draft-07/schema#",

  "type": "object",
  "additionalProperties": true,
  "required": [ "manifest_version", "name", "version" ],

  "properties": {
    "manifest_version": {
      "type": "number",
      "description": "One integer specifying the version of the manifest file format your package requires.",
      "enum": [ 2, 3 ]
    },
    // ...other stuff
  }
}

Editor support

For automatic manifest.json validation and autocompletion in your editor, install the companion VS Code extension, which binds this schema to your manifest files.

Related projects

• browser-extension-manifest-fields
• browser-extension-capabilities
• browser-extension-compat-data
• extension-from-store
• parse5-asset-patcher

License

MIT (c) Cezar Augusto.