Руководство по совместимости
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 следуют своим графикам; здесь они не проверялись.