Home Categories About Contact Blog Free Tools

MV2 to MV3 Converter

Automatically convert your Chrome extension manifest from Manifest V2 to Manifest V3

Instant Conversion
Auto-Migration
100% Free

Service Workers

Background scripts → Service workers

Host Permissions

Separated from permissions

Action API

Unified browser/page action

Web Request

declarativeNetRequest API

Upload Your Manifest

Upload your manifest.json file or paste the JSON content

Drag & Drop manifest.json

or click to browse

Migration Guide

Key changes and what you need to know

Background Changes

  • Service Workers: Replace background.page/scripts with background.service_worker
  • No DOM: Service workers cannot access DOM or window object
  • Persistent: Remove "persistent": false, service workers are non-persistent by default

Permissions

  • Host Permissions: Move URL patterns to host_permissions array
  • Optional: Add optional_host_permissions for runtime requests
  • Activeab: Use chrome.scripting instead of chrome.tabs.executeScript

Action API

  • Unified: browser_action and page_action merged into action
  • API: Use chrome.action instead of chrome.browserAction
  • Icons: Same icon configuration format applies

Web Request

  • New API: Use declarativeNetRequest instead of webRequest blocking
  • Rules: Define static and dynamic rules in JSON format
  • Performance: More efficient but requires code restructuring

Important Notes

  • This converter handles basic manifest structure changes. You may need to update your JavaScript code to work with service workers.
  • Review the converted manifest carefully, especially if you use webRequest, tabs, or background scripts extensively.
  • Test your extension thoroughly after conversion. Some APIs have different behaviors in MV3.
  • Chrome Web Store will stop accepting MV2 extensions soon. Migrate as early as possible.
Featured On

Trusted Platforms

Trustpilot
SH
SaaSHub