Průvodce kompatibilitou
Manifest V2 a Manifest V3: co může nainstalovat každá verze Chrome
Od Chrome 87 do 156: podle linie verzí uvidíte, kdy který formát rozšíření funguje, kdy přestane a co zkontrolovat před stažením starší verze.
Co jsou Manifest V2 a Manifest V3
- Manifest V2
- Starší formát rozšíření Chrome. Rozšíření běží se stálou stránkou na pozadí a mohou přímo zachytávat a měnit síťové požadavky. Chrome ho opouští.
- Manifest V3
- Současný formát, podporovaný od Chrome 88. Pozadí se mění na service worker spouštěný podle potřeby, filtrování sítě používá deklarativní pravidla (declarativeNetRequest) a oprávnění jsou přísnější.
Soubor manifest.json každého rozšíření uvádí, jaký formát používá; dále zkráceně MV2 a MV3.
Manifest V2 je pryč
Prohlížeč už neobsahuje žádný přepínač ani zásadu MV2; každý způsob je odmítnut. MV3 nemá horní hranici – fungovalo od verze 88 po 156, nejnovější testovanou. Jediné zbývající riziko je příliš starý prohlížeč.
156Nejnovější testovaná verze: MV2 všude odmítnuto, MV3 funguje.Změřeno151Všechny přepínače příkazového řádku odstraněny.Změřeno
MV2 je odmítáno
Pro běžné uživatele MV2 skončilo: instalace se odmítá a nelze ji znovu zapnout; režim pro vývojáře ani „Načíst rozbalené“ nepomohou. Udržet ho mohou jen podnikové zásady (do 138) a přepínače příkazového řádku (do 150).
150Poslední verze, kde fungují přepínače příkazového řádku (s dalším zapnutím).Změřeno139Podniková zásada ExtensionManifestV2Availability odstraněna.Změřeno137MV2 ve výchozím stavu odmítnuto; znovu zapnout nelze.Změřeno
MV2 ve výchozím stavu vypnuté
Rozšíření MV2 se stále instalují, ale přicházejí vypnutá (unsupportedManifestVersion). Uživatel je může znovu zapnout na chrome://extensions a pak normálně fungují. Google změnu zaváděl postupně od října 2024, takže někteří uživatelé se s ní setkali později.
říjen 2024Google zahajuje postupné zavádění pro uživatele.Dokumentace Chrome129Výchozí hodnota v kódu začíná MV2 vypínat.Změřeno
Oba formáty vedle sebe, MV3 se doplňuje
Funguje MV2 i MV3 – nejshovívavější období. Nová API MV3 přibývají postupně; rozšíření, které je používá bez uvedení minimální verze, se ve starších prohlížečích nainstaluje, ale tyto funkce selžou.
127–128MV2 stále funguje; Chrome začíná na stránce rozšíření varovat před koncem MV2.Změřeno120Oprávnění userScripts je k dispozici (uživatel ho musí také zapnout).Dokumentace Chrome114sidePanel je k dispozici.Změřeno109Rozhraní offscreen je k dispozici; dřívější verze se nainstalují a běží, ale volání selhávají.Změřenoleden 2022Internetový obchod Chrome přestává přijímat nová rozšíření MV2 (pravidlo obchodu, ne změna prohlížeče).Pravidla obchodu96Oprávnění declarativeNetRequestWithHostAccess je k dispozici.Dokumentace Chrome92Pozadí s ES moduly se začíná spouštět.Změřeno
MV3 se dostává do stabilní verze
Od Chrome 88 se rozšíření MV3 instalují a fungují. Pozadí napsané jako ES modul ("type": "module") se ale až do verze 92 nainstaluje a nikdy nespustí.
88–91Modulové pozadí se zobrazuje se service workerem, ale nikdy se nespustí.Změřeno88Základní MV3: instalace, zapnutí i pozadí fungují.Změřeno
Roky jen s MV2
Manifest V2 je jediný stabilní formát. Rozšíření MV3 se ve stabilním Chrome nainstaluje a vypadá zapnuté, ale jeho skript na pozadí se nikdy nespustí – nejhůře odhalitelná chyba.
87Stabilní 87 přijímá nejvýše manifest_version 2; pozadí service_worker je jen v kanálu Dev.Zdrojový kód
Od Chrome 137 je MV2 odmítáno a běžní uživatelé to nemají jak obejít.
Chrome 129–136 rozšíření MV2 automaticky vypíná, ale uživatelé je mohou znovu zapnout.
MV3 vyžaduje Chrome 88 nebo novější; starší prohlížeče ho nainstalují, ale nikdy nespustí.
Pokud je prohlížeč starší než minimum_chrome_version v manifestu, odmítne se přetažení na stránku rozšíření, načtení rozbaleného rozšíření i instalace pomocí zásad.
Před stažením starší verze
- Zkontrolujte verzi manifestu: v Chrome 137 a novějším vybírejte jen MV3.
- Zkontrolujte minimální verzi: pod ní se instalace odmítne.
- Ve starém prohlížeči vyberte nejnovější kompatibilní verzi, nebo nejdřív aktualizujte.
Metodika a omezení
Testováno 18. 10. 2026 v Linuxu na Chrome for Testing 113–156 a snímcích Chromia 87–112 s testovacími rozšířeními a skutečnými Google Translate 2.0.13 / 2.0.18 a AdBlock, abychom odlišili „nainstalováno“, „zapnuto“ a „pozadí opravdu běží“; instalace CRX byla ověřena vynucenou instalací přes podnikové zásady. Chrome for Testing nemá postupné zavádění, takže verze výše ukazují, kdy začne platit kód – skuteční uživatelé mohli změny zaznamenat později. Windows, Mac, Edge a další prohlížeče Chromium nebyly zahrnuty. Data po verzi 150 jsou odhadnuta podle čtyřtýdenního cyklu vydávání Chrome.
Edge a další prohlížeče Chromium mají vlastní harmonogramy; zde nebyly testovány.