Посібник із сумісності
Manifest V2 і Manifest V3: що може встановити кожна версія Chrome
Від Chrome 87 до 156: за лінією версій видно, коли працює кожен формат розширень, коли перестає і що перевірити перед завантаженням старої версії.
Що таке Manifest V2 і Manifest V3
- Manifest V2
- Старий формат розширень Chrome. Розширення працюють із постійною фоновою сторінкою й можуть напряму перехоплювати та змінювати мережеві запити. Chrome від нього відмовляється.
- Manifest V3
- Поточний формат, підтримується з Chrome 88. Фон стає service worker, що запускається за потреби, фільтрування мережі використовує декларативні правила (declarativeNetRequest), а дозволи суворіші.
У manifest.json кожного розширення вказано, який формат воно використовує; нижче — скорочено MV2 і MV3.
Manifest V2 більше немає
У браузері не лишилося ні перемикачів, ні політик MV2; усі способи відхиляються. MV3 не має верхньої межі: він працював із 88 по 156, найновішу перевірену версію. Лишається єдиний ризик — надто старий браузер.
156Найновіша перевірена версія: MV2 відхиляється всюди, MV3 працює.Перевірено151Усі параметри командного рядка видалено.Перевірено
MV2 не встановлюється
Для звичайних користувачів MV2 закінчився: встановлення відхиляється, увімкнути знову не можна; режим розробника й «Завантажити розпаковане розширення» не допомагають. Зберегти його можуть лише корпоративна політика (до 138) і параметри командного рядка (до 150).
150Остання версія, де працюють параметри командного рядка (з додатковим увімкненням).Перевірено139Видалено корпоративну політику ExtensionManifestV2Availability.Перевірено137MV2 відхиляється за замовчуванням; знову ввімкнути не можна.Перевірено
MV2 вимкнено за замовчуванням
Розширення MV2 ще встановлюються, але надходять вимкненими (unsupportedManifestVersion). Користувач може знову ввімкнути їх на chrome://extensions, і вони працюють як звичайно. Google поширював це поступово з жовтня 2024 року, тож дехто зіткнувся з цим пізніше.
жовт. 2024 р.Google починає поступове поширення для користувачів.Документація Chrome129Типове значення в коді починає вимикати MV2.Перевірено
Обидва формати поруч, MV3 доповнюється
Працюють і MV2, і MV3 — найпоблажливіший період. Нові API MV3 з’являються по одному; розширення, яке їх використовує без зазначеної мінімальної версії, встановиться в старому браузері, але ці функції не спрацюють.
127–128MV2 ще працює; Chrome починає попереджати про відмову від MV2 на сторінці розширень.Перевірено120Доступний дозвіл userScripts (користувач також має його ввімкнути).Документація Chrome114Доступна sidePanel.Перевірено109Доступний API offscreen; у ранніших версіях розширення встановлюється й працює, але виклики не спрацьовують.Перевіреносіч. 2022 р.Інтернет-магазин Chrome перестає приймати нові розширення MV2 (правило магазину, а не зміна браузера).Правила магазину96Доступний дозвіл declarativeNetRequestWithHostAccess.Документація Chrome92Фон на ES-модулях починає працювати.Перевірено
MV3 у стабільній версії
З Chrome 88 розширення MV3 встановлюються й працюють. Але фон, написаний як ES-модуль ("type": "module"), до версії 92 встановлюється й ніколи не запускається.
88–91Фон-модуль відображається із service worker, але ніколи не стартує.Перевірено88Базовий MV3: встановлення, увімкнення й фон працюють.Перевірено
Роки лише MV2
Manifest V2 — єдиний стабільний формат. Розширення MV3 встановлюється й виглядає ввімкненим у стабільному Chrome, але його фоновий скрипт ніколи не запускається — найнепомітніша поломка.
87Стабільна версія 87 приймає щонайбільше manifest_version 2; фон service_worker є лише в каналі Dev.Вихідний код
З Chrome 137 MV2 не встановлюється, і звичайні користувачі не мають способу це обійти.
Chrome 129–136 автоматично вимикає розширення MV2, але користувачі можуть знову їх увімкнути.
MV3 потребує Chrome 88 або новішого; старіші браузери встановлюють його, але ніколи не запускають.
Перед завантаженням старої версії
- Перевірте версію маніфесту: у Chrome 137 і новіших обирайте лише MV3.
- Перевірте мінімальну версію: нижче неї встановлення відхиляється.
- Якщо браузер старий, оберіть найновішу сумісну версію або спершу оновіться.
Методика й обмеження
Перевірено 18 жовт. 2026 р. на Linux із Chrome for Testing 113–156 і знімками Chromium 87–112, з тестовими розширеннями та справжніми Google Translate 2.0.13 / 2.0.18 і AdBlock, щоб розрізнити «встановлено», «увімкнено» й «фон справді працює»; встановлення CRX перевірено примусовим встановленням через корпоративну політику. У Chrome for Testing немає поступового поширення, тож версії вище показують, коли набуває чинності код, — реальні користувачі могли побачити зміни пізніше. Windows, Mac, Edge та інші браузери на Chromium не перевірялися. Дати після 150 оцінено за чотиритижневим циклом випусків Chrome.
Edge та інші браузери на Chromium мають власні графіки; тут вони не перевірялися.