Chrome Extension Edge Migration — Developer Guide
2 min readPorting Chrome Extensions to Microsoft Edge
Microsoft Edge is built on the Chromium engine, which means most Chrome extensions can be ported with minimal or no modifications. This guide covers the key considerations for publishing your extension on the Edge Add-ons store.
Compatibility Overview
Edge is Chromium-based, so Chrome extensions typically work without changes. The chrome.* namespace is fully supported. Edge also supports the browser.* namespace (Promise-based, similar to Firefox) if you prefer cross-browser compatibility.
Manifest Support
Both Manifest V2 and Manifest V3 are supported in Edge. However, we recommend migrating to MV3 for future-proofing and better compatibility across browsers.
Key Differences
Edge-Specific APIs
Edge provides some unique APIs beyond Chrome:
sidePanelAPI: Similar to Chrome’s side panel but with different behavior- Enterprise APIs: Additional group policy support for organizational deployments
Feature Detection
Always check for Edge-specific features before using them:
// Edge detection
const isEdge = navigator.userAgent.includes('Edg/');
if (isEdge && window.sidePanel) {
// Use Edge-specific side panel API
}
Build Script for Dual Publishing
Create a build configuration that works for both stores:
// build.config.js
const config = {
chrome: {
store: 'Chrome Web Store',
output: 'dist/chrome'
},
edge: {
store: 'Edge Add-ons',
output: 'dist/edge'
}
};
module.exports = config;
Edge Add-ons Store
Submission Process
- Create a Microsoft account
- Register as an Edge extension developer
- Upload the same ZIP file (identical to CWS)
- Provide store-specific metadata:
- Edge-specific keywords
- Screenshots optimized for Edge store
- Privacy policy URL
Store Listing Optimization
- Add “Edge” and “Microsoft” to keywords
- Use screenshots that show the extension in Edge
- Highlight Edge-specific features in description
Analytics
Set up separate analytics for Edge users:
// Separate tracking for Edge
const analytics = isEdge ? 'UA-Edge-XXXX' : 'UA-Chrome-XXXX';
Review Process
Edge’s review process is similar to CWS but typically faster (24-48 hours). They have similar policies but may be more lenient on certain enterprise-focused extensions.
Testing
Load your extension in Edge for testing:
- Open
edge://extensions - Enable “Developer mode”
- Click “Load unpacked” and select your extension directory
Dual Publishing
Maintain a single codebase for both stores:
- Use environment variables for store-specific configurations
- Test thoroughly on both browsers before release
- Monitor separate analytics for each platform
Cross-Reference
Related Articles
Related Articles
Turn Your Extension Into a Business
Ready to monetize? The Extension Monetization Playbook covers freemium models, Stripe integration, subscription architecture, and growth strategies for Chrome extension developers.
Part of the Chrome Extension Guide by theluckystrike. Built at zovo.one.