Overview of Microsoft Edge extensions - Microsoft Edge Developer documentation (2024)

  • Article

A Microsoft Edge extension, also called an add-on, is a small app that developers use to add or modify features of Microsoft Edge to improve a user's browsing experience. An extension provides a niche experience or function that is important to a target audience. You publish a Microsoft Edge extension at the Microsoft Edge Add-ons website.

You can create a Microsoft Edge extension if you have an idea or product that is based upon either a specific web browser, or improvements to features of specific webpages. Examples of companion experiences include ad blockers and password managers.

An extension should include at least the following features:

  • An app manifest JSON file that contains basic platform information.
  • A JavaScript file that defines the function.
  • HTML and CSS files that define the user interface.

To work directly with a specific part of the browser, such as a window or tab, you must send API requests, and must often reference the browser by name.

Overview of Microsoft Edge extensions - Microsoft Edge Developer documentation (1)

See also:

  • Everything to know about browser extensions - introduction for users.
  • Add, turn off, or remove extensions in Microsoft Edge - support steps for users.

Basic guidance

Great places to begin your extension development tutorials and documentation research are sites hosted by the browser organizations. Some of the popular browsers to build extensions for include Microsoft Edge, Safari, Firefox, Chrome, Opera, and Brave.

The following table isn't exhaustive or definitive; it's just a starting point for your research.

Web browserChromium-based?Extension development webpage
SafariNoSafari App Extensions
FirefoxNoBrowser Extensions
ChromeYesAPI Reference
OperaYesExtensions Documentation
BraveYesUses Chrome Web Store
Microsoft EdgeYesMicrosoft Edge Add-ons Developer

Important

Many of the tutorials on these sites use browser-specific APIs that might not match the browser for the app you are developing. In most cases, a Chromium extension works as-is in different Chromium browsers and the APIs work as expected. Some less-common APIs might be browser-specific. Links to the tutorials are in the See also section, below.

Why Chromium?

If your goal is to publish your extension in the extensions store for each browser, your extension must be modified for each version to target and run in each distinct browser environment. For example, Safari extensions can use both web and native code to communicate with counterpart native applications. The last four browsers in the previous table use the same code package and minimize the need to maintain parallel versions. These browsers are based on the Chromium open-source project.

Benefits of creating a Chromium extension include writing the fewest lines of code. It also targets the maximum number of extension stores and ultimately the maximum number of users who can find and acquire your extension.

The following content focuses mostly on Chromium extensions.

Browser compatibility and extension testing

Occasionally, API parity doesn't exist between Chromium browsers. For example, there are differences in the identity and payment APIs. To make sure your extension meets customer expectations, review API status through the following official browser documentation:

The APIs that you require define the changes that you must make to address the differences between each browser. You might need to create slightly different code packages with small differences for each store.

To test your extension in different environments before you submit the extension to a browser store, side-load the extension into your browser while you develop it.

Publish your extension to browser stores

You can submit and seek browser extensions in the following browser stores.

Some stores allow you to download listed extensions from other browsers. However, cross-browser access isn't guaranteed by browser stores. To make sure your users find your extension in different browsers, you should maintain a listing on each browser extension store.

Users might need to install your extension in different browsers. In this scenario, you can migrate existing Chromium extensions from one browser to another.

Migrate an existing extension to Microsoft Edge

If you've already developed an extension for another Chromium-based browser, you can submit it to the Microsoft Edge Add-ons website. You don't need to rewrite your extension or verify that it works in Microsoft Edge. However, when you migrate an existing Chromium extension to other Chromium browsers, make certain the same APIs or alternatives are available for your target browser.

For more information on porting your Chrome extension to Microsoft Edge, see Port Chrome extensions to Microsoft Edge. After you port your extension to the target browser, the next step is to publish it.

Publish to the Microsoft Edge Add-ons website

You publish a Microsoft Edge extension at the Microsoft Edge Add-ons website.

To start publishing a Microsoft Edge extension, you must register for a developer account with a Microsoft account (MSA) email account to submit your extension listing to the Microsoft Edge Add-ons website. The email address of a Microsoft account (MSA) includes @outlook.com, @live.com, or @hotmail.com. When you choose an email address to register, consider whether you must transfer or share ownership of the Microsoft Edge extension with other people in your organization. After registration is complete, you can submit an extension listing.

To submit an extension at the Microsoft Edge Add-ons website, you need to provide the following items:

  • An archive (.zip) file that contains your code files.
  • All required visual assets, which include a logo and small promotional tile.
  • Optional promotional media, such as screenshots, promotional tiles, and a video URL.
  • Information that describes your extension such as the name, short description, and a privacy policy link.

Different stores might have different submission requirements. The above list summarizes the requirements for publishing an extension for Microsoft Edge; for details, see Publish a Microsoft Edge extension.

After you've successfully submitted your extension, your extension undergoes a review process and either passes or fails the certification process. Owners are notified of the outcome and given next steps as required. If you submit an extension update at the Microsoft Edge Add-ons website, that begins a new review process.

The Featured badge

A Featured badge in the Microsoft Edge Add-ons website indicates that the extension has been determined to follow Microsoft's recommended best practices related to security, privacy, transparency, and user experience.

Overview of Microsoft Edge extensions - Microsoft Edge Developer documentation (2)

When you hover on a Featured badge, the tooltip reads: This extension follows all of Microsoft's recommended practices and has been verified.

For example, the extension has a Featured badge at the Microsoft Edge Add-ons website.

The Microsoft Edge Add-ons team reviews each extension for adherence to Best practices for extensions before granting the extension a Featured badge. Badged extensions are curated solely for the purpose of providing Microsoft Edge users with secure browsing tools and high-quality experiences. Developers cannot pay to receive a Featured badge for an extension.

To help protect your browser settings, extensions that don't comply with the Best Practices for extensions are not badged.

Just because an extension doesn't have a Featured badge, doesn't mean the extension is unsafe. It simply means that the extension doesn't meet Microsoft's security and quality standards to be badged as Featured.

See also

  • Everything to know about browser extensions - introduction for users.
  • Add, turn off, or remove extensions in Microsoft Edge - support steps for users.
  • Extension concepts and architecture
  • Manage Microsoft Edge extensions in the enterprise

External links:

Extensions for Visual Studio Code rather than for Microsoft Edge:

  • Microsoft Edge DevTools extension for Visual Studio Code
  • webhint extension for Visual Studio Code
Overview of Microsoft Edge extensions - Microsoft Edge Developer documentation (2024)
Top Articles
Latest Posts
Recommended Articles
Article information

Author: Virgilio Hermann JD

Last Updated:

Views: 6572

Rating: 4 / 5 (41 voted)

Reviews: 88% of readers found this page helpful

Author information

Name: Virgilio Hermann JD

Birthday: 1997-12-21

Address: 6946 Schoen Cove, Sipesshire, MO 55944

Phone: +3763365785260

Job: Accounting Engineer

Hobby: Web surfing, Rafting, Dowsing, Stand-up comedy, Ghost hunting, Swimming, Amateur radio

Introduction: My name is Virgilio Hermann JD, I am a fine, gifted, beautiful, encouraging, kind, talented, zealous person who loves writing and wants to share my knowledge and understanding with you.