From 76721433226f3864ea7163773f5aafdaef79ddbb Mon Sep 17 00:00:00 2001 From: Michael Hoffman <45407486+mikehoffms@users.noreply.github.com> Date: Fri, 7 Aug 2026 08:38:16 -0700 Subject: [PATCH] Manifest timeline for Partner Center and Microsoft Edge (#3892) * date * rework timeline section * some, then everyone * date * dummy change to trigger build * * list items * for Partner Center & Edge * 'store' global in file * cleanup See Also * un-paren store * global: Manifest V# * Timeline for migrating to Manifest V3 * structural edit * For more details, see * CTA to top of article * not mid-sent. list * not more * # anchor * move para to serve as lead-in * move mv3 overview to overview article * linkfix * contact * trim rows * not * list item in cell * inc cmts, structural edit * concat sents & See lists * planned end of support * Edge based on Chromium * to list format --- .../developer-guide/devtools-extension.md | 4 +- .../extensions/developer-guide/manifest-v3.md | 91 ++++++++----------- ...e-your-extension-from-manifest-v2-to-v3.md | 46 +++++++++- microsoft-edge/extensions/landing/index.yml | 2 +- .../extensions/publish/publish-extension.md | 4 +- microsoft-edge/toc.yml | 2 +- 6 files changed, 86 insertions(+), 63 deletions(-) diff --git a/microsoft-edge/extensions/developer-guide/devtools-extension.md b/microsoft-edge/extensions/developer-guide/devtools-extension.md index a4e395b406..07c5426614 100644 --- a/microsoft-edge/extensions/developer-guide/devtools-extension.md +++ b/microsoft-edge/extensions/developer-guide/devtools-extension.md @@ -113,7 +113,7 @@ This file is required, for an extension. The manifest contains the following in | `name` | The name of the extension that will appear under `edge://extensions/`. | | `description` | The description of the extension that will be displayed under the name of the extension. | | `version` | The version of the extension that will appear next to the name of the extension. | -| `manifest_version` | Determines the set of features that the extension will be using, such as network request modification. The current version is version `3`. To learn more about this version and the differences with version `2`, see [Overview and timelines for migrating to Manifest V3](../developer-guide/manifest-v3.md). | +| `manifest_version` | Determines the set of features that the extension will be using, such as network request modification. The current version is version `3`. To learn more about this version and the differences with version `2`, see [Timeline for migrating to Manifest V3](../developer-guide/manifest-v3.md). | | `devtools_page` | The path to an HTML file that's run every time DevTools is opened, and loads the extension's JavaScript files. This page isn't rendered in DevTools. | | `content_scripts` | The JavaScript or CSS files to use when the user opens specified webpages. See [Content scripts](https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts) in the Chrome docs. | | `permissions` | The local device requires permissions to view its system memory capacity, since the script calls API for that. | @@ -387,7 +387,7 @@ See also: * [Sample: Custom DevTools tool](./devtools-extension-sample.md) * [Overview of DevTools](../../devtools/overview.md) -* [Overview and timelines for migrating to Manifest V3](../developer-guide/manifest-v3.md) +* [Timeline for migrating to Manifest V3](../developer-guide/manifest-v3.md) * [Supported APIs for Microsoft Edge extensions](../developer-guide/api-support.md) * [Get started developing an extension](../getting-started/index.md) * [Sample: Picture viewer pop-up webpage](../samples/picture-viewer-popup-webpage.md) diff --git a/microsoft-edge/extensions/developer-guide/manifest-v3.md b/microsoft-edge/extensions/developer-guide/manifest-v3.md index 2874573f9c..1ed89f92a2 100644 --- a/microsoft-edge/extensions/developer-guide/manifest-v3.md +++ b/microsoft-edge/extensions/developer-guide/manifest-v3.md @@ -1,81 +1,62 @@ --- -title: Overview and timelines for migrating to Manifest V3 -description: Timelines for migration from Manifest V2 to V3, and overview of V3, which reduces fragmentation of the web for developers and enhances privacy, security, and performance for end users. +title: Timeline for migrating to Manifest V3 +description: Timeline for migration from Manifest V2 to V3, which reduces fragmentation of the web for developers and enhances privacy, security, and performance for end users. author: MSEdgeTeam ms.author: msedgedevrel ms.topic: article ms.service: microsoft-edge ms.subservice: extensions -ms.date: 04/26/2024 +ms.date: 08/07/2026 --- -# Overview and timelines for migrating to Manifest V3 +# Timeline for migrating to Manifest V3 -A _manifest file_ is the blueprint of an extension. A manifest file for an extension includes information such as the version number of the extension, the title of the extension, and permissions needed to run the extension. The manifest file follows the format specified by Manifest V2 or Manifest V3. +To plan the migration of your extension from Manifest V2 to Manifest V3, the following timeline shows the planned end of support for Manifest V2 at Microsoft Partner Center, at the [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com) store, and in Microsoft Edge. -Users browse and install extensions for Microsoft Edge from [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com). +| Date | Changes | +|---|---| +| Jul. 2022 | Partner Center (and the Edge Add-ons store) no longer accepts new Manifest V2 extensions. To publish a new extension, use Manifest V3. | +| Aug. 2026 | At Partner Center, if your extension uses Manifest V2, a Manifest V2 deprecation warning is displayed. | +| Early 2027 | For enterprise customers, deprecation of Manifest V2 extensions is expected to begin. | +| TBD | Partner Center (and the Edge Add-ons store) will no longer accept updates to extensions that continue to use Manifest V2. You can submit an update that migrates a Manifest V2 extension to Manifest V3. | - -## Overview of changes in Manifest V3 + +## Migrate your extension to Manifest V3 -Migrating from Manifest V2 to Manifest V3 brings several structural changes to how extensions are handled by the browser. +If your extension still uses Manifest V2, migrate to Manifest V3 now. After the Manifest V3 version of your extension is ready, submit the update through Partner Center. -In Oct. 2020, Microsoft announced the [decision to embrace Manifest V3](https://blogs.windows.com/msedgedev/2020/10/14/extension-manifest-chromium-edge/) to help reduce fragmentation of the web for all developers and enhance privacy, security, and performance for end users. +See [Migrate an extension from Manifest V2 to V3](./migrate-your-extension-from-manifest-v2-to-v3.md). -Manifest V3 is an initiative of the [Chromium project](https://www.chromium.org/Home/). -An overview of the changes involved, as described in [Migrate an extension from Manifest V2 to V3](./migrate-your-extension-from-manifest-v2-to-v3.md): + +## Background -* Background pages have been replaced by service workers. +In Oct. 2020, Microsoft announced the decision to embrace Manifest V3, which: +* Reduces fragmentation of the web, for developers. +* Enhances privacy, security, and performance, for end users. -* Network request modifications are now handled by the new `declarativeNetRequest` API. +See [Manifest V3 changes are now available to test in Microsoft Edge](https://blogs.windows.com/msedgedev/2020/10/14/extension-manifest-chromium-edge/). -* Remotely hosted code is no longer allowed. An extension can only run JavaScript that's included within its own package. -* Support for Promises has been added to many methods. Callbacks are still supported, as an alternative. + +## Timeline for Chromium changes -* Various minor feature improvements. +Microsoft Edge is based on the Chromium browser engine. Manifest V3 is an initiative of the [Chromium project](https://www.chromium.org/Home/). +For information about end of support for Manifest V2 extensions in the Chromium browser engine project, see: +* [Manifest V2 support timeline](https://developer.chrome.com/docs/extensions/develop/migrate/mv2-deprecation-timeline) +* [The phase-out timeline](https://developer.chrome.com/blog/resuming-the-transition-to-mv3#the_phase-out_timeline) in _Resuming the transition to Manifest V3_. - -## Manifest timeline for the Chromium browser engine -Chromium has revised the timelines for ending support for Manifest V2. See: - -* [Manifest V2 support timeline](https://developer.chrome.com/docs/extensions/develop/migrate/mv2-deprecation-timeline) -* [The phase-out timeline](https://developer.chrome.com/blog/resuming-the-transition-to-mv3#the_phase-out_timeline) in _Resuming the transition to Manifest V3_. - - - -## Manifest timeline for Microsoft Edge and Partner Center - -To help you plan the migration of your extension from Manifest V2 to Manifest V3, consider the following schedule for support for Manifest V2 and V3 in Microsoft Edge and Microsoft Partner Center. - -The Microsoft Edge team will independently decide on MV3 migration timelines for Microsoft Edge extensions and share an update here. We continue to analyze the concerns raised by extension developers and explore the optimal path for the Microsoft Edge extensions ecosystem. Meanwhile, to plan the migration of your extension from Manifest V2 to Manifest V3, see [Manifest timeline for the Chromium browser engine](#manifest-timeline-for-the-chromium-browser-engine), above. - - -**The Microsoft Edge team is currently in the process of updating this MV3 migration timeline.** - -| Timeframe | Microsoft Partner Center changes | Microsoft Edge changes | -|--- |--- |--- | -| Jul. 2022 (already in effect) | Microsoft Partner Center will no longer accept new Manifest V2 extensions with visibility set as `Hidden` or `Public`. | No change. | -| TBD | Microsoft Partner Center will no longer accept updates to existing Manifest V2 extensions. Developers can submit updates for migrating a V2 extension to V3. | Microsoft Edge stops running Manifest V2 extensions. Enterprises can allow Manifest V2 extensions to run on Microsoft Edge, by using enterprise policies. | -| TBD | No change. | Manifest V2 extensions will no longer function in Microsoft Edge, even with the use of enterprise policies. | - -Manifest V2 extensions will continue to be supported through Enterprise policies at least until the date in the Chromium Manifest V2 support timeline. - -Microsoft continues to iteratively improve the platform and address the feedback shared by extension developers. Share your questions, comments, and concerns: -* [Contact the Microsoft Edge extensions team](../contact.md) -* [Microsoft Edge Insider](https://techcommunity.microsoft.com/t5/microsoft-edge-insider/ct-p/MicrosoftEdgeInsider) - forum about Microsoft Edge at Microsoft Tech Community. -* [@MSEdgeDev](https://twitter.com/msedgedev/) - Microsoft Edge team on X (Twitter). - - - - - + ## See also + * [Migrate an extension from Manifest V2 to V3](./migrate-your-extension-from-manifest-v2-to-v3.md) -* [Manifest V2 support timeline](https://developer.chrome.com/docs/extensions/develop/migrate/mv2-deprecation-timeline) -* [The phase-out timeline](https://developer.chrome.com/blog/resuming-the-transition-to-mv3#the_phase-out_timeline) in _Resuming the transition to Manifest V3_. -* [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com) - Browse and install extensions for Microsoft Edge. +* [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com) store. +* [Manifest V3 changes are now available to test in Microsoft Edge](https://blogs.windows.com/msedgedev/2020/10/14/extension-manifest-chromium-edge/) - blog post. + +Chromium docs: +* [Chromium project](https://www.chromium.org/Home/) +* [Manifest V2 support timeline](https://developer.chrome.com/docs/extensions/develop/migrate/mv2-deprecation-timeline) +* [The phase-out timeline](https://developer.chrome.com/blog/resuming-the-transition-to-mv3#the_phase-out_timeline) in _Resuming the transition to Manifest V3_. diff --git a/microsoft-edge/extensions/developer-guide/migrate-your-extension-from-manifest-v2-to-v3.md b/microsoft-edge/extensions/developer-guide/migrate-your-extension-from-manifest-v2-to-v3.md index ca6caad274..e25bb6a02a 100644 --- a/microsoft-edge/extensions/developer-guide/migrate-your-extension-from-manifest-v2-to-v3.md +++ b/microsoft-edge/extensions/developer-guide/migrate-your-extension-from-manifest-v2-to-v3.md @@ -15,6 +15,26 @@ ms.date: 05/26/2021 This article lists important aspects of Manifest V3, which is the current version of the Chromium Extensions platform. For guidance on migrating your extension to Manifest V3 from the Chromium project, see [Migrate to Manifest V3](https://developer.chrome.com/docs/extensions/develop/migrate). + +## Overview of changes in Manifest V3 + +Migrating an extension from using Manifest V2 to using Manifest V3 brings several structural changes to how extensions are handled by the browser: + +* Remotely hosted code is no longer allowed. An extension can only run JavaScript that's included within its own package. See [Remotely hosted code](#remotely-hosted-code), below. + +* Edge extensions can use controls that enable you to allow or restrict access to websites at runtime. See [Run-time host permissions](#run-time-host-permissions), below. + +* Content scripts are required to have the same permissions as the webpage into which the scripts are injected. See [Cross-origin requests in content scripts](#cross-origin-requests-in-content-scripts), below. + +* Network request modifications are now handled by the new `declarativeNetRequest` API. See [Web Request API](#web-request-api), below. + +* Background pages have been replaced by service workers. See [Background service workers](#background-service-workers), below. + +* Support for Promises has been added to many methods. Callbacks are still supported, as an alternative. + +* Various minor feature improvements. + + ## Remotely hosted code @@ -22,13 +42,15 @@ Today, some parts of the extensions code are hosted remotely, and aren't include To ensure that the extensions at Microsoft Edge Add-ons are validated, the Microsoft Edge extensions team disallows extensions from using remotely hosted code. This change makes extensions more secure. -Developers will need to package and submit all code that is used by the extension, for validation. Alternatively, you can use the `eval()` function in a sandboxed iframe. See [Use eval() in sandboxed iframes](https://developer.chrome.com/docs/extensions/how-to/security/sandboxing-eval). +You'll need to package and submit all code that is used by the extension, for validation. Alternatively, you can use the `eval()` function in a sandboxed iframe. See [Use eval() in sandboxed iframes](https://developer.chrome.com/docs/extensions/how-to/security/sandboxing-eval). ## Run-time host permissions -At installation time, it's possible for extensions to request blanket permissions to access all sites and content. These permissions allow extensions to operate with minimum intervention, and so present a risk for user privacy and security. To improve transparency, the Microsoft Edge extensions team provides controls that enable users to allow or restrict access to websites at runtime. +At installation time, it's possible for extensions to request blanket permissions to access all sites and content. These permissions allow extensions to operate with minimum intervention, and so present a risk for user privacy and security. + +To improve transparency, the Microsoft Edge extensions team provides controls that enable users to allow or restrict access to websites at runtime. @@ -74,3 +96,23 @@ The Microsoft Edge extensions team publishes updates at our blog. You can provi | removed | `"persistent": false,` | | If `background` is included, `service_ worker` is required | If `background` is included, `service_ worker` is optional | | Separated into two different keys: `"permissions": [...], "host_permissions": [...],` | `"permissions": [...],` | + + + +## See also + + +* [Overview of changes in Manifest V3](./manifest-v3.md) in _Timeline for migrating to Manifest V3_. + +External: +* [Manifest V3 changes are now available in Microsoft Edge](https://techcommunity.microsoft.com/t5/articles/manifest-v3-changes-are-now-available-in-microsoft-edge/m-p/1780254) - blog post. +* [Extensions](/deployedge/microsoft-edge-policies#extensions) in _Microsoft Edge – Policies_. +* [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com) store. + +Chromium docs: +* [Migrate to Manifest V3](https://developer.chrome.com/docs/extensions/develop/migrate) +* [Use eval() in sandboxed iframes](https://developer.chrome.com/docs/extensions/how-to/security/sandboxing-eval) +* [Changes to Cross-Origin Requests in Chrome Extension Content Scripts](https://www.chromium.org/Home/chromium-security/extension-content-script-fetches). +* [Web Request API](https://developer.chrome.com/docs/extensions/reference/webRequest) +* [Declarative Net Request API](https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest) +* [Migrate to a service worker](https://developer.chrome.com/docs/extensions/develop/migrate/to-service-workers) diff --git a/microsoft-edge/extensions/landing/index.yml b/microsoft-edge/extensions/landing/index.yml index 779620b046..0d42b295a5 100644 --- a/microsoft-edge/extensions/landing/index.yml +++ b/microsoft-edge/extensions/landing/index.yml @@ -89,7 +89,7 @@ landingContent: linkLists: - linkListType: how-to-guide links: - - text: Overview and timelines for migrating to Manifest V3 + - text: Timeline for migrating to Manifest V3 url: ../developer-guide/manifest-v3.md - text: Migrate an extension from Manifest V2 to V3 diff --git a/microsoft-edge/extensions/publish/publish-extension.md b/microsoft-edge/extensions/publish/publish-extension.md index 8f0c6dc7fe..f0360e0ad5 100644 --- a/microsoft-edge/extensions/publish/publish-extension.md +++ b/microsoft-edge/extensions/publish/publish-extension.md @@ -364,7 +364,7 @@ If the extension executes remote code: The extension should avoid the use of remote code unless absolutely necessary. Remote code requires additional review, and might increase certification time. See also: -* [Overview of changes in Manifest V3](../developer-guide/manifest-v3.md#overview-of-changes-in-manifest-v3), in _Overview and timelines for migrating to Manifest V3_. +* [Overview of changes in Manifest V3](../developer-guide/migrate-your-extension-from-manifest-v2-to-v3.md#overview-of-changes-in-manifest-v3) in _Migrate an extension from Manifest V2 to V3_. * [Remove remotely hosted code](https://developer.chrome.com/docs/extensions/develop/migrate/improve-security#remove-remote-code) in _Improve extension security_, in Chrome docs. @@ -802,7 +802,7 @@ If you experience issues when registering as an extension developer or when subm * [Extension concepts and architecture](../getting-started/index.md) * [Port a Chrome extension to Microsoft Edge](../developer-guide/port-chrome-extension.md) * [Manifest file format for extensions](../getting-started/manifest-format.md) - * [Overview of changes in Manifest V3](../developer-guide/manifest-v3.md#overview-of-changes-in-manifest-v3), in _Overview and timelines for migrating to Manifest V3_. +* [Overview of changes in Manifest V3](../developer-guide/migrate-your-extension-from-manifest-v2-to-v3.md#overview-of-changes-in-manifest-v3) in _Migrate an extension from Manifest V2 to V3_. * [Register as a Microsoft Edge extension developer](./create-dev-account.md) * [Best practices for extensions](../developer-guide/best-practices.md) * [Contact the Microsoft Edge extensions team](../contact.md) diff --git a/microsoft-edge/toc.yml b/microsoft-edge/toc.yml index 4c9fb0e88c..296ae02be5 100644 --- a/microsoft-edge/toc.yml +++ b/microsoft-edge/toc.yml @@ -1274,7 +1274,7 @@ - name: Migrating to V3 items: - - name: Overview and timelines for migrating to Manifest V3 + - name: Timeline for migrating to Manifest V3 href: ./extensions/developer-guide/manifest-v3.md - name: Migrate an extension from Manifest V2 to V3