Guida alla compatibilità
Manifest V2 e Manifest V3: cosa può installare ogni versione di Chrome
Da Chrome 87 a 156, segui la linea delle versioni per capire quando funziona ogni formato di estensione, quando smette di funzionare e cosa controllare prima di scaricare una versione vecchia.
Cosa sono Manifest V2 e Manifest V3
- Manifest V2
- Il vecchio formato delle estensioni di Chrome. Le estensioni usano una pagina in background sempre attiva e possono intercettare e modificare direttamente le richieste di rete. Chrome lo sta abbandonando.
- Manifest V3
- Il formato attuale, supportato da Chrome 88. Il background diventa un service worker avviato quando serve, il filtraggio di rete usa regole dichiarative (declarativeNetRequest) e le autorizzazioni sono più rigide.
Il manifest.json di ogni estensione indica il formato usato; di seguito li abbreviamo in MV2 e MV3.
Manifest V2 è scomparso
Il browser non contiene più alcuna opzione o criterio per MV2; ogni metodo viene rifiutato. MV3 non ha un limite superiore: ha funzionato dalla 88 alla 156, la più recente testata. L’unico rischio rimasto è un browser troppo vecchio.
156Ultima versione testata: MV2 rifiutato ovunque, MV3 funziona.Misurato151Tutte le opzioni da riga di comando eliminate.Misurato
MV2 rifiutato
Per gli utenti comuni MV2 è finito: l’installazione viene rifiutata e non si può riattivare; la modalità sviluppatore e «Carica estensione non pacchettizzata» non aiutano. Solo il criterio aziendale (fino alla 138) e le opzioni da riga di comando (fino alla 150) lo tengono in vita.
150Ultima versione in cui funzionano le opzioni da riga di comando (con una riattivazione in più).Misurato139Rimosso il criterio aziendale ExtensionManifestV2Availability.Misurato137MV2 rifiutato per impostazione predefinita; non si può riattivare.Misurato
MV2 disattivato per impostazione predefinita
Le estensioni MV2 si installano ancora, ma arrivano disattivate (unsupportedManifestVersion). L’utente può riattivarle in chrome://extensions e funzionano normalmente. Google ha distribuito il cambiamento a fasi da ottobre 2024, quindi alcuni utenti lo hanno visto più tardi.
ott 2024Google avvia la distribuzione graduale agli utenti.Doc Chrome129Il valore predefinito del codice inizia a disattivare MV2.Misurato
I due formati convivono, MV3 si completa
MV2 e MV3 funzionano entrambi: la fase più tollerante. Le nuove API MV3 arrivano una alla volta; un’estensione che le usa senza dichiarare una versione minima si installa sui browser più vecchi, ma quelle funzioni non vanno.
127–128MV2 funziona ancora; Chrome inizia ad avvisare della fine di MV2 nella pagina delle estensioni.Misurato120Autorizzazione userScripts disponibile (l’utente deve anche attivarla).Doc Chrome114sidePanel disponibile.Misurato109API offscreen disponibile; le versioni precedenti si installano e funzionano, ma le chiamate falliscono.Misuratogen 2022Il Chrome Web Store smette di accettare nuove estensioni MV2 (regola dello store, non un cambiamento del browser).Regole dello store96Autorizzazione declarativeNetRequestWithHostAccess disponibile.Doc Chrome92I background con moduli ES iniziano a funzionare.Misurato
MV3 arriva nella versione stabile
Da Chrome 88 le estensioni MV3 si installano e funzionano. Un background scritto come modulo ES ("type": "module") però si installa senza mai avviarsi fino alla 92.
88–91Un background a modulo compare con un service worker ma non si avvia mai.Misurato88MV3 di base: installazione, attivazione e background funzionano.Misurato
Gli anni solo MV2
Manifest V2 è l’unico formato stabile. Un’estensione MV3 si installa e sembra attiva in Chrome stabile, ma il suo script in background non si avvia mai: il problema più difficile da notare.
87La versione stabile 87 accetta al massimo manifest_version 2; i background service_worker esistono solo nel canale Dev.Codice sorgente
Da Chrome 137 MV2 viene rifiutato e gli utenti comuni non hanno alcun modo per aggirarlo.
Chrome 129–136 disattiva automaticamente le estensioni MV2, ma gli utenti possono riattivarle.
MV3 richiede Chrome 88 o successivo; i browser più vecchi lo installano ma non lo avviano mai.
Se il browser è più vecchio della minimum_chrome_version del manifest, il trascinamento nella pagina delle estensioni, il caricamento non pacchettizzato e l’installazione tramite criterio vengono tutti rifiutati.
Prima di scaricare una versione vecchia
- Controlla la versione del manifest: con Chrome 137 o successivo scegli solo MV3.
- Controlla la versione minima: al di sotto, l’installazione viene rifiutata.
- Con un browser vecchio scegli la versione compatibile più recente, oppure aggiorna prima il browser.
Metodo e limiti
Test eseguiti il 18 ott 2026 su Linux con Chrome for Testing 113–156 e snapshot di Chromium 87–112, usando estensioni di prova e le vere Google Translate 2.0.13 / 2.0.18 e AdBlock per distinguere «installata», «attivata» e «il background si avvia davvero»; il percorso di installazione CRX è stato verificato con un’installazione forzata tramite criterio aziendale. Chrome for Testing non prevede distribuzioni graduali, quindi le versioni sopra indicano quando il codice entra in vigore: gli utenti reali potrebbero aver visto i cambiamenti più tardi. Windows, Mac, Edge e altri browser Chromium non sono stati coperti. Le date dopo la 150 sono stimate in base al ciclo di rilascio di quattro settimane di Chrome.
Edge e gli altri browser Chromium seguono i propri tempi; qui non sono stati testati.