Skip to content

Commit a030bbe

Browse files
Rewrote "Best practices for extensions" (#3577)
* rewrote article * link Featured * reseq intro * Update microsoft-edge/extensions/developer-guide/best-practices.md --------- Co-authored-by: Patrick Brosset <patrick.brosset@microsoft.com>
1 parent f3b95ca commit a030bbe

1 file changed

Lines changed: 72 additions & 9 deletions

File tree

microsoft-edge/extensions/developer-guide/best-practices.md

Lines changed: 72 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,24 +6,87 @@ ms.author: msedgedevrel
66
ms.topic: conceptual
77
ms.service: microsoft-edge
88
ms.subservice: extensions
9-
ms.date: 11/20/2023
9+
ms.date: 09/22/2025
1010
---
1111
# Best practices for extensions
1212

13-
Follow these Best Practices to implement your extension and list it at [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com).
13+
Follow these best practices to implement your extension and list it at [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com). Build an extension that conforms to Microsoft's standards for security, privacy, performance, and user experience. These principles help ensure your extension is safe, reliable, and valuable to users.
14+
15+
The Microsoft Edge extensions team continues to gather feedback from developers and users to evolve these best practices. To ensure that your extension remains compliant and competitive, review this guidance regularly.
16+
17+
Meeting these guidelines doesn't guarantee that your extension will receive the **Featured** badge; see [The Featured badge](../index.md#the-featured-badge) in _Overview of Microsoft Edge extensions_.
18+
19+
Follow these best practices, to improve the quality, reliability, and user experience of your extension, and to maximize your extension's visibility.
20+
21+
22+
<!-- ====================================================================== -->
23+
## Security
24+
25+
* Make sure that your extension doesn't pose any security threats to users.
26+
27+
* Request only the permissions that are necessary for core functionality.
28+
29+
* Use secure coding practices, and avoid third-party libraries with known vulnerabilities.
30+
31+
* Respond promptly to any flagged issues.
32+
33+
34+
<!-- ====================================================================== -->
35+
## Privacy
36+
37+
* Handle user data responsibly and in accordance with your published privacy policy.
38+
39+
* Clearly disclose what data is collected and how it is used.
40+
41+
* Avoid tracking or fingerprinting users without explicit consent.
42+
43+
44+
<!-- ====================================================================== -->
45+
## User experience
46+
47+
* Provide a clean, intuitive, and responsive interface.
48+
49+
* Avoid disruptive ads, pop-ups, or misleading prompts.
50+
51+
* Ensure the extension integrates seamlessly into the browsing experience.
52+
53+
54+
<!-- ====================================================================== -->
55+
## Store listing
56+
57+
* Provide clear and concise descriptions, to set accurate user expectations.
58+
59+
* Include high-quality screenshots that reflect the actual user experience.
1460

1561

1662
<!-- ====================================================================== -->
17-
## Design a high-quality extension
63+
## Performance and stability
1864

19-
Build an extension that conforms to Microsoft's standards for security, privacy, transparency, and user experience.
65+
* Minimize background activity and memory usage.
2066

21-
**Security**: Make sure that your extension doesn't pose any security threats to users.
67+
* Avoid crashes, freezes, or excessive CPU consumption.
2268

23-
**Privacy**: Make sure that your extension handles user data appropriately.
69+
* Test your extension across different versions of Microsoft Edge and supported platforms.
2470

25-
**User experience**: Make sure that your extension provides a clean, intuitive, and seamless user experience on the web without ads that can be interruptive.
71+
* Refer to [Minimize an extension's impact on page load time](./minimize-page-load-time-impact.md).
72+
73+
74+
<!-- ====================================================================== -->
75+
## Responsiveness to user feedback
76+
77+
* Monitor user reviews, and respond constructively.
78+
79+
* Address bugs and usability issues in a timely manner.
80+
81+
* Maintain a regular update cadence, to improve reliability and user trust.
82+
83+
84+
<!-- ====================================================================== -->
85+
## See also
86+
<!-- all links in article -->
2687

27-
**Store listing**: Make sure that your extension's store listing sets correct user expectations and clearly communicates what the extension does.
88+
* [The Featured badge](../index.md#the-featured-badge) in _Overview of Microsoft Edge extensions_.
89+
* [Minimize an extension's impact on page load time](./minimize-page-load-time-impact.md)
2890

29-
We'll continue gathering input about Developer experiences with extensions, and updating these Best Practices.
91+
External:
92+
* [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com)

0 commit comments

Comments
 (0)