Guia de compatibilidade
Manifest V2 e Manifest V3: o que cada versão do Chrome consegue instalar
Do Chrome 87 ao 156, acompanhe a linha de versões para ver quando cada formato de extensão funciona, quando falha e o que verificar antes de baixar uma versão antiga.
O que são o Manifest V2 e o Manifest V3
- Manifest V2
- O formato antigo de extensões do Chrome. As extensões rodam com uma página em segundo plano permanente e podem interceptar e alterar solicitações de rede diretamente. O Chrome está abandonando esse formato.
- Manifest V3
- O formato atual, compatível a partir do Chrome 88. O segundo plano vira um service worker que inicia sob demanda, a filtragem de rede usa regras declarativas (declarativeNetRequest) e as permissões são mais rígidas.
O manifest.json de cada extensão informa qual formato ela usa; abaixo, eles aparecem abreviados como MV2 e MV3.
O Manifest V2 acabou
O navegador não tem mais nenhuma opção ou política de MV2; todos os métodos são recusados. O MV3 não tem limite superior: funcionou da 88 à 156, a mais recente testada. O único risco que resta é um navegador antigo demais.
156Versão mais recente testada: MV2 recusado em todos os casos, MV3 funciona.Medido151Todas as opções de linha de comando removidas.Medido
MV2 recusado
Para usuários comuns, o MV2 acabou: a instalação é recusada e não pode ser reativada; o modo de desenvolvedor e “Carregar sem compactação” não ajudam. Só a política empresarial (até a 138) e as opções de linha de comando (até a 150) ainda o mantêm.
150Última versão em que as opções de linha de comando funcionam (com uma reativação extra).Medido139Política empresarial ExtensionManifestV2Availability removida.Medido137MV2 recusado por padrão; não pode ser reativado.Medido
MV2 desativado por padrão
Extensões MV2 ainda são instaladas, mas chegam desativadas (unsupportedManifestVersion). O usuário pode reativá-las em chrome://extensions e elas funcionam normalmente. O Google liberou isso em etapas a partir de outubro de 2024, então alguns usuários só viram mais tarde.
out. de 2024O Google inicia a liberação em etapas para os usuários.Docs do Chrome129O padrão do código começa a desativar o MV2.Medido
Os dois formatos convivem e o MV3 se completa
MV2 e MV3 funcionam — a fase mais tolerante. As novas APIs do MV3 chegam uma a uma; uma extensão que as usa sem declarar uma versão mínima é instalada em navegadores antigos, mas esses recursos falham.
127–128O MV2 ainda roda; o Chrome começa a avisar sobre o fim do MV2 na página de extensões.Medido120Permissão userScripts disponível (o usuário também precisa ativá-la).Docs do Chrome114sidePanel disponível.Medido109API offscreen disponível; versões anteriores instalam e rodam, mas as chamadas falham.Medidojan. de 2022A Chrome Web Store deixa de aceitar novas extensões MV2 (política da loja, não uma mudança do navegador).Política da loja96Permissão declarativeNetRequestWithHostAccess disponível.Docs do Chrome92Segundos planos com módulos ES começam a rodar.Medido
O MV3 chega à versão estável
A partir do Chrome 88, extensões MV3 são instaladas e funcionam. Um segundo plano escrito como módulo ES ("type": "module") ainda é instalado sem nunca rodar até a versão 92.
88–91Um segundo plano de módulo aparece com service worker, mas nunca inicia.Medido88MV3 básico: instala, ativa e roda o segundo plano.Medido
Os anos só com MV2
O Manifest V2 é o único formato estável. Uma extensão MV3 é instalada e parece ativada no Chrome estável, mas o script em segundo plano nunca roda — a falha mais difícil de perceber.
87A versão estável 87 aceita no máximo manifest_version 2; segundos planos service_worker existem só no canal Dev.Código-fonte
A partir do Chrome 137, o MV2 é recusado e usuários comuns não têm como contornar isso.
O Chrome 129–136 desativa extensões MV2 automaticamente, mas os usuários podem reativá-las.
O MV3 precisa do Chrome 88 ou mais recente; navegadores mais antigos instalam, mas nunca rodam.
Antes de baixar uma versão antiga
- Verifique a versão do manifesto: no Chrome 137 ou mais recente, escolha só MV3.
- Verifique a versão mínima: abaixo dela, a instalação é recusada.
- Em um navegador antigo, escolha a versão compatível mais recente ou atualize antes.
Método e limitações
Testado em 18 de out. de 2026 no Linux com Chrome for Testing 113–156 e snapshots do Chromium 87–112, usando extensões de teste e as reais Google Translate 2.0.13 / 2.0.18 e AdBlock para separar “instalada”, “ativada” e “o segundo plano realmente roda”; a instalação de CRX foi verificada com instalação forçada por política empresarial. O Chrome for Testing não tem liberações em etapas, então as versões acima mostram quando o código entra em vigor; usuários reais podem ter visto as mudanças mais tarde. Windows, Mac, Edge e outros navegadores Chromium não foram cobertos. As datas depois da 150 foram estimadas pelo ciclo de lançamento de quatro semanas do Chrome.
O Edge e outros navegadores Chromium seguem seus próprios cronogramas; eles não foram testados aqui.