{ "manifest_version": 3 }

{ "name": "My Extension" }

{ "version": "1.2.3" }

{ "description": "A short summary of what this extension does" }

{ "icons": { "16": "icons/16.png", "32": "icons/32.png", "48": "icons/48.png", "128": "icons/128.png" } }

{ "default_locale": "en" }

{ "version_name": "1.2.3 beta" }

{
  "action": {
    "default_popup": "popup.html",
    "default_icon": { "16": "icons/action16.png", "32": "icons/action32.png" },
    "default_title": "Click to open"
  }
}

{ "background": { "service_worker": "background.js", "type": "module" } }

{
  "content_scripts": [{
    "matches": ["https://*.example.com/*"],
    "js": ["content.js"],
    "css": ["styles.css"],
    "run_at": "document_idle",
    "match_about_blank": false,
    "match_origin_as_fallback": false,
    "world": "ISOLATED",
    "all_frames": false,
    "exclude_matches": ["https://example.com/admin/*"],
    "include_globs": ["*example*"],
    "exclude_globs": ["*private*"]
  }]
}

{ "permissions": ["activeTab", "alarms", "storage", "scripting", "tabs", "notifications"] }

{ "optional_permissions": ["bookmarks", "history"] }

{ "host_permissions": ["https://*.example.com/*", "*://mail.google.com/*"] }

{ "optional_host_permissions": ["https://*/*"] }

{
  "web_accessible_resources": [{
    "resources": ["images/logo.png", "styles/inject.css"],
    "matches": ["https://*.example.com/*"]
  }, {
    "resources": ["scripts/inject.js"],
    "extension_ids": ["other-ext-id"],
    "use_dynamic_url": true
  }]
}

{
  "content_security_policy": {
    "extension_pages": "script-src 'self'; object-src 'self'",
    "sandbox": "sandbox allow-scripts; script-src 'self' 'unsafe-inline' 'unsafe-eval'"
  }
}

{
  "commands": {
    "_execute_action": {
      "suggested_key": { "default": "Ctrl+Shift+Y", "mac": "Command+Shift+Y" },
      "description": "Open popup"
    },
    "toggle-feature": {
      "suggested_key": { "default": "Alt+Shift+T" },
      "description": "Toggle feature"
    }
  }
}

{ "omnibox": { "keyword": "ext" } }

chrome.omnibox.onInputChanged.addListener((text, suggest) => {
  suggest([
    { content: text + ' option1', description: 'First suggestion for <match>' + text + '</match>' },
    { content: text + ' option2', description: 'Second suggestion' }
  ]);
});

chrome.omnibox.onInputEntered.addListener((text, disposition) => {
  // disposition: 'currentTab', 'newForegroundTab', 'newBackgroundTab'
  const url = `https://example.com/search?q=${encodeURIComponent(text)}`;
  if (disposition === 'currentTab') {
    chrome.tabs.update({ url });
  } else {
    chrome.tabs.create({ url });
  }
});

{ "devtools_page": "devtools.html" }

// devtools.js (loaded by devtools.html)
chrome.devtools.panels.create('My Panel', 'icons/panel.png', 'panel.html');

chrome.devtools.panels.elements.createSidebarPane('Props', (sidebar) => {
  sidebar.setExpression('document.querySelector("body").dataset');
});

{ "chrome_url_overrides": { "newtab": "newtab.html" } }

{ "options_ui": { "page": "options.html", "open_in_tab": false } }

{ "side_panel": { "default_path": "sidepanel.html" } }

{
  "externally_connectable": {
    "matches": ["https://*.example.com/*"],
    "ids": ["other-ext-id", "*"],
    "accepts_tls_channel_id": false
  }
}

{ "storage": { "managed_schema": "schema.json" } }

{
  "type": "object",
  "properties": {
    "serverUrl": { "type": "string", "description": "Corporate API endpoint" },
    "enableLogging": { "type": "boolean", "description": "Enable debug logging" },
    "blockedDomains": { "type": "array", "items": { "type": "string" } }
  }
}

const config = await chrome.storage.managed.get(['serverUrl', 'enableLogging']);

{
  "declarative_net_request": {
    "rule_resources": [
      { "id": "ruleset_1", "enabled": true, "path": "rules/block.json" },
      { "id": "ruleset_2", "enabled": false, "path": "rules/redirect.json" }
    ]
  }
}

{
  "manifest_version": 3,
  "name": "Productivity Tracker",
  "version": "2.1.0",
  "description": "Track time spent on websites and boost your productivity",
  "default_locale": "en",
  "minimum_chrome_version": "116",

  "icons": {
    "16": "icons/16.png", "32": "icons/32.png",
    "48": "icons/48.png", "128": "icons/128.png"
  },

  "action": {
    "default_popup": "popup.html",
    "default_icon": { "16": "icons/action16.png", "32": "icons/action32.png" },
    "default_title": "View Stats"
  },

  "background": { "service_worker": "background.js", "type": "module" },

  "content_scripts": [{
    "matches": ["https://*/*"],
    "js": ["content/tracker.js"],
    "run_at": "document_idle"
  }],

  "permissions": ["activeTab", "alarms", "notifications", "storage", "tabs", "sidePanel"],
  "optional_permissions": ["history", "bookmarks"],
  "host_permissions": ["https://*.example.com/*"],
  "optional_host_permissions": ["https://*/*"],

  "web_accessible_resources": [{
    "resources": ["images/*", "styles/inject.css"],
    "matches": ["https://*/*"]
  }],

  "content_security_policy": {
    "extension_pages": "script-src 'self'; object-src 'self'"
  },

  "options_ui": { "page": "options.html", "open_in_tab": false },
  "side_panel": { "default_path": "sidepanel.html" },

  "commands": {
    "_execute_action": {
      "suggested_key": { "default": "Ctrl+Shift+P", "mac": "Command+Shift+P" },
      "description": "Open popup"
    }
  },

  "externally_connectable": { "matches": ["https://*.example.com/*"] },
  "storage": { "managed_schema": "schema/managed.json" },

  "declarative_net_request": {
    "rule_resources": [{ "id": "trackers", "enabled": true, "path": "rules/trackers.json" }]
  }
}

← Previous manifest-json-reference Next → memory-management