You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: microsoft-edge/extensions-chromium/publish/publish-extension.md
+62-55Lines changed: 62 additions & 55 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ ms.author: msedgedevrel
6
6
ms.topic: conceptual
7
7
ms.service: microsoft-edge
8
8
ms.subservice: extensions
9
-
ms.date: 01/07/2025
9
+
ms.date: 01/08/2025
10
10
---
11
11
# Publish a Microsoft Edge extension
12
12
@@ -128,7 +128,7 @@ On the **Availability** page for the extension, fill in the **Visibility** and *
128
128
<!-- ------------------------------ -->
129
129
#### Visibility
130
130
131
-
Select one of the following visibility options to define whether your extension is discoverable in the [Microsoft Edge Add-ons website](https://microsoftedge.microsoft.com/addons/Microsoft-Edge-Extensions-Home).
131
+
Select one of the following visibility options to define whether your extension is discoverable in the Microsoft Edge Add-ons website:
132
132
133
133
*`Public` (default) - Allows everyone to discover your extension through search, browsing in the Microsoft Edge Add-ons website, or using the listing URL to your extension in the Microsoft Edge Add-ons website. The listing URL is available on your Partner Center dashboard on the Extension **Overview** page.
134
134
@@ -156,49 +156,60 @@ Define the specific markets in which you plan to offer your extension. The defa
## Step 4: Enter properties describing your extension
158
158
159
-
On the **Properties** page for the extension, enter the following information to specify properties of your extension. The properties are displayed to users at the Microsoft Edge Add-ons website.
159
+
1.On the left, click **Properties**.
160
160
161
-
| Property name | Required? | Description |
162
-
|---|---|---|
163
-
|**Category**| Required | The category that best describes your extension. Listing your extension in the right category helps users find your extension easily and understand more about it. |
164
-
|**Privacy policy requirements**| Required | Indicate if your extension accesses, collects, or transmits any personal information. Your extension might fail the certification step if you select **Yes** and you don't provide a `Privacy policy URL`. |
165
-
|**Privacy policy URL**| - | A valid privacy policy URL to communicate how your extension follows privacy laws and regulations. You're responsible for ensuring your extension follows privacy laws and regulations. You're also responsible for providing a privacy policy URL if any personal information is being accessed, transmitted, or collected by your extension. To determine if your extension requires a privacy policy, see [Microsoft Store App Developer Agreement](https://go.microsoft.com/fwlink/?linkid=528905) and [Developer policies for the Microsoft Edge Add-ons store](/legal/microsoft-edge/extensions/developer-policies). |
166
-
|**Website URL**| - | A webpage that provides additional information about your extension. The `Website URL` must point to a webpage on your own website, not the web listing for your extension in the [Microsoft Edge Add-ons website](https://microsoftedge.microsoft.com/addons/Microsoft-Edge-Extensions-Home). The `Website URL` helps users learn more about your extension, its features, and any other relevant information. |
167
-
|**Support contact details**| - | The URL to your support webpage, or the email address to contact your support team. |
168
-
|**Mature content**| - | Checkbox to specify if your extension includes mature content. Extension rating helps determine the appropriate age group of the target audience of your extension. To help determine if your extension has mature content, see [Developer policies for the Microsoft Edge Add-ons store](/legal/microsoft-edge/extensions/developer-policies). |
161
+
The **Properties** page for the extension opens.
169
162
170
-
Properties that are not indicated as Required are Optional.
163
+
1. Enter the following information:
171
164
172
-
Your developer/organization name, **Website URL**, and **Support contact details** that you submitted during registration are displayed to users on the Microsoft Edge Add-ons website.
165
+
| Property name | Required? | Description |
166
+
|---|---|---|
167
+
|**Category**| Required | The category that best describes your extension. Listing your extension in the right category helps users find your extension easily and understand more about it. |
168
+
|**Privacy policy requirements**| Required | Indicate if your extension accesses, collects, or transmits any personal information. Your extension might fail the certification step if you select **Yes** and you don't provide a `Privacy policy URL`. |
169
+
|**Privacy policy URL**| - | A valid privacy policy URL to communicate how your extension follows privacy laws and regulations. You're responsible for ensuring your extension follows privacy laws and regulations. You're also responsible for providing a privacy policy URL if any personal information is being accessed, transmitted, or collected by your extension. To determine if your extension requires a privacy policy, see [Microsoft Store App Developer Agreement](https://go.microsoft.com/fwlink/?linkid=528905) and [Developer policies for the Microsoft Edge Add-ons store](/legal/microsoft-edge/extensions/developer-policies). |
170
+
|**Website URL**| - | A webpage that provides additional information about your extension. The `Website URL` must point to a webpage on your own website, not the web listing for your extension in the Microsoft Edge Add-ons website. The `Website URL` helps users learn more about your extension, its features, and any other relevant information. |
171
+
|**Support contact details**| - | The URL to your support webpage, or the email address to contact your support team. |
172
+
|**Mature content**| - | Checkbox to specify if your extension includes mature content. Extension rating helps determine the appropriate age group of the target audience of your extension. To help determine if your extension has mature content, see [Developer policies for the Microsoft Edge Add-ons store](/legal/microsoft-edge/extensions/developer-policies). |
173
+
174
+
Properties that are not indicated as Required are Optional.
175
+
176
+
The properties are displayed to users at the Microsoft Edge Add-ons website. Your developer/organization name, **Website URL**, and **Support contact details** that you submitted during registration are displayed to users on the Microsoft Edge Add-ons website.
173
177
174
-
After filling in the **Properties** page for the extension, click the **Save & Continue** button.
178
+
1.After filling in the **Properties** page for the extension, click the **Save & Continue** button.
## Step 5: Add store listing details for your extension
181
185
182
-
1. In the **Store Listings** page, click the **Edit details** button:
186
+
1. On the left, click **Store listings**.
187
+
188
+
The **Store Listings** page opens:
183
189
184
-

190
+

185
191
192
+
1. Click the **Edit details** button.<!-- The **Details** page opens. todo: confirm UI -->
186
193
187
-
The information provided in the **Store Listings**page is displayed to users who view your listing on the Microsoft Edge Add-ons website. Even though some fields are optional, you should provide as much information as possible.
194
+
1. In the **Language details**section, fill in the following properties:
188
195
189
-
In the **Language details** section, fill in the following properties.
196
+
| Property name | Required? | Description |
197
+
|---|---|---|
198
+
|**Display name**| Required for at least one language | The `name` of your extension specified in the manifest file of your extension. To change the store display name after submission, you can update the name in the manifest file, create a new extension package, and then re-upload it. |
199
+
|**Description**| Required for each language | The `description` field explains what your extension does, why users should install it, and any other relevant information users need to know. <br/>***Length:** Minimum 250 characters, maximum 5000 characters. <br/>***Clarity:** Must clearly describe the full functionality of your extension. <br/>***Completeness:** Should be thorough and include all important details. <br/>***Appropriateness:** Must not contain any misleading or inappropriate content. |
200
+
|**Extension Store logo**| Required for each language | An image that represents your company or `extension logo` with an aspect ratio of 1, and recommended size of 300 x 300 pixels. You can copy the asset from one language to all other languages by using the **Duplicate** button, which is displayed next to this field after you upload your logo for the language. |
201
+
|**Small promotional tile**| - | The `Small promotional tile` image is used to display your extension alongside other extensions in the store. The size of the image should be 440 x 280 pixels. You can copy the asset from one language to all other languages by using the **Duplicate** button. The button is found following the field after you upload a promotional tile for the language. |
202
+
|**Large promotional tile**| - |`Large promotion tiles` are used in the store to feature extensions more prominently in the Microsoft Edge Add-ons website. The images, if submitted, are visible to the users. The size of the PNG files must be 1400 x 560 pixels. You can copy the asset from one language to all other languages by using the **Duplicate** button. The button is found following the field after you upload a promotional tile for the language. |
203
+
|**Screenshots**| - | You can submit a maximum of 10 `screenshots` describing the functionality of your extension in detail. The size of the screenshots must be either 640 x 480 pixels or 1280 x 800 pixels. You can copy the asset from one language to all other languages by using the **Duplicate** button. The button is found following the field after you upload at least one for the language. |
204
+
|**YouTube video URL**| - | You can include a promotional YouTube video of your extension. The `YouTube video URL` video is displayed on the store listing page of your extension. |
205
+
|**Short description**| Required for at least one language | To edit the `short description`, you must update the description field in your manifest file of your extension package and reupload it. |
206
+
|**Search terms**| - |`Search terms` are single words or phrases that help discover your extension when a user searches in the Microsoft Edge Add-ons website. The search terms aren't displayed to users. |
190
207
191
-
| Property name | Required? | Description |
192
-
|---|---|---|
193
-
|**Display name**| Required for at least one language | The `name` of your extension specified in the manifest file of your extension. To change the store display name after submission, you can update the name in the manifest file, create a new extension package, and then re-upload it. |
194
-
|**Description**| Required for each language | The `description` field explains what your extension does, why users should install it, and any other relevant information users need to know. <br/>***Length:** Minimum 250 characters, maximum 5000 characters. <br/>***Clarity:** Must clearly describe the full functionality of your extension. <br/>***Completeness:** Should be thorough and include all important details. <br/>***Appropriateness:** Must not contain any misleading or inappropriate content. |
195
-
|**Extension Store logo**| Required for each language | An image that represents your company or `extension logo` with an aspect ratio of 1, and recommended size of 300 x 300 pixels. You can copy the asset from one language to all other languages by using the **Duplicate** button, which is displayed next to this field after you upload your logo for the language. |
196
-
|**Small promotional tile**| - | The `Small promotional tile` image is used to display your extension alongside other extensions in the store. The size of the image should be 440 x 280 pixels. You can copy the asset from one language to all other languages by using the **Duplicate** button. The button is found following the field after you upload a promotional tile for the language. |
197
-
|**Large promotional tile**| - |`Large promotion tiles` are used in the store to feature extensions more prominently in the Microsoft Edge Add-ons website. The images, if submitted, are visible to the users. The size of the PNG files must be 1400 x 560 pixels. You can copy the asset from one language to all other languages by using the **Duplicate** button. The button is found following the field after you upload a promotional tile for the language. |
198
-
|**Screenshots**| - | You can submit a maximum of 10 `screenshots` describing the functionality of your extension in detail. The size of the screenshots must be either 640 x 480 pixels or 1280 x 800 pixels. You can copy the asset from one language to all other languages by using the **Duplicate** button. The button is found following the field after you upload at least one for the language. |
199
-
|**YouTube video URL**| - | You can include a promotional YouTube video of your extension. The `YouTube video URL` video is displayed on the store listing page of your extension. |
200
-
|**Short description**| Required for at least one language | To edit the `short description`, you must update the description field in your manifest file of your extension package and reupload it. |
201
-
|**Search terms**| - |`Search terms` are single words or phrases that help discover your extension when a user searches in the Microsoft Edge Add-ons website. The search terms aren't displayed to users. |
208
+
The information provided in the **Store Listings** page is displayed to users who view your listing on the Microsoft Edge Add-ons website. Even though some fields are optional, you should provide as much information as possible.
209
+
210
+
<!--
211
+
1. Click **Save** in the upper right. todo: confirm UI
212
+
-->
202
213
203
214
204
215
<!-- ------------------------------ -->
@@ -230,7 +241,11 @@ You can duplicate your assets from one language across other languages by using
230
241
<!-- ------------------------------ -->
231
242
#### YouTube video URL requirements
232
243
233
-
Make sure your video meets the following requirements.
244
+
Fill in required fields in the **Details for English (United States)** page, scrolling down as needed:
245
+
246
+

247
+
248
+
If you are linking to a video, make sure your video meets the following requirements.
234
249
235
250
* Verify that the content of the YouTube video follows the [Developer policies for the Microsoft Edge Add-ons store](/legal/microsoft-edge/extensions/developer-policies).
236
251
@@ -250,11 +265,6 @@ To submit the YouTube video URL of your video:
250
265
<!-- ------------------------------ -->
251
266
#### Search terms requirements
252
267
253
-
Fill in required fields in the **Details for English (United States)** page, scrolling down as needed:
254
-
255
-

256
-
257
-
258
268
1. In the **Details for English (United States)** page (or equivalent language/market page), in the **Search terms** text box, enter search terms:
259
269
260
270

@@ -273,39 +283,37 @@ Fill in required fields in the **Details for English (United States)** page, scr
## Step 6: Complete the submission by providing testing notes
275
285
276
-
On the **Submit your extension** page, you can optionally add notes for certification to help test your extension.
286
+
On the **Submit your extension** page, you can optionally add notes for certification to help test your extension. When you submit your extension, use the **Notes for certification** text box to provide additional information to the certification testers. The additional information helps ensure that your extension is tested correctly. If your extension isn't fully tested, it might fail certification.
277
287
278
-
1. Click the **Submit** button.
279
-
280
-
The **Submit your extension** page opens.
288
+
To add notes for certification:
281
289
290
+
1. Click the **Submit** button.
282
291
283
-
<!-- ------------------------------ -->
284
-
#### Notes for certification (optional)
292
+
The **Submit your extension** page opens:
285
293
286
-
In the **Submit your extension** page, fill in the **Notes for certification** text box.<!-- in the **Notes for certification** section. -->
294
+

287
295
288
-

296
+
1. Fill in the **Notes for certification** text box.
289
297
290
-
When you submit your extension, use the **Notes for certification** page to provide additional information to the certification testers. The additional information helps ensure that your extension is tested correctly. If your extension isn't fully tested, it might fail certification.
298
+
You can compose and save your notes in a text editor, such as Visual Studio Code, and then paste the notes into the text box. Include any needed information, such as:
291
299
292
-
Include the following information, as necessary:
300
+
* Usernames and passwords for test accounts.
293
301
294
-
* Usernames and passwords for test accounts.
302
+
* Steps to access hidden or locked features.
295
303
296
-
* Steps to access hidden or locked features.
304
+
* Expected differences in functionality based on region or other user settings.
297
305
298
-
* Expected differences in functionality based on region or other user settings.
306
+
* If your submission is an update to an existing extension, include information about the changes made to the extension.
299
307
300
-
* If your submission is an update to an existing extension, include information about the changes made to the extension.
308
+
* Any additional information that testers must understand about your submission.
301
309
302
-
* Any additional information that testers must understand about your submission.
310
+
1. Click the **Publish** button, in the upper right.
303
311
304
-
After you provide the information, click the **Publish** button to submit your extension to the [Microsoft Edge Add-ons website](https://microsoftedge.microsoft.com/addons/Microsoft-Edge-Extensions-Home).
312
+
Your extension is submitted to the Microsoft Edge Add-ons website.
305
313
306
-
Your submission then proceeds to the certification step. The certification process can take up to seven business days after your submission.
314
+
Your submission then proceeds to the certification step. The certification process can take up to seven business days after your submission.
307
315
308
-
After your submission passes certification, your extension is published in the Microsoft Edge Add-ons website. The status of your extension in the Partner Center dashboard changes to **In the Store**.
316
+
After your submission passes certification, your extension is published in the Microsoft Edge Add-ons website. The status of your extension in the Partner Center dashboard changes to **In the Store**.
0 commit comments