Skip to content

Update Submit your App MSIX #5466

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 13 commits into
base: docs
Choose a base branch
from
306 changes: 306 additions & 0 deletions hub/apps/publish/best-practices/best-practices.md

Large diffs are not rendered by default.

6 changes: 3 additions & 3 deletions hub/apps/publish/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,15 +114,15 @@ For more information, please visit [Reserve your app's name - Windows apps | Mic

- **Packages**: Upload the app packages for your app which will be downloaded by the Store user. [Upload app packages - Windows apps | Microsoft Learn](./publish-your-app/msix/upload-app-packages.md)

- **Store Listings**: Enter the app description, screenshots, and logos that will be displayed on your app’s Product Details Page (PDP) in the Store, by creating a Store listing. [Create app store listings - Windows apps | Microsoft Learn](./publish-your-app/msix/create-app-store-listing.md)
- **Store Listings**: Enter the app description, screenshots, and logos that will be displayed on your app’s Product Details Page (PDP) in the Store, by creating a Store listing. [Create app store listings - Windows apps | Microsoft Learn](./publish-your-app/msix/add-and-edit-store-listing-info.md)

- **Submission options (optional)**: Enter notes for certification or decide when your app should publish to the Store using submission options. [Manage submission options - Windows apps | Microsoft Learn](./publish-your-app/msix/manage-submission-options.md)

4. After you complete a section, click on **Save**. Once all sections are complete and you are ready to submit, click on **Submit for certification**.

If your draft is missing any necessary information, it will be marked as **Incomplete.**

For more information, please visit [Create an app submission - Windows apps | Microsoft Learn.](./publish-your-app/msix/create-app-submission.md)
For more information, please visit [Create an app submission - Windows apps | Microsoft Learn.](./publish-your-app/msix/add-and-edit-store-listing-info.md)

## App certification process [MSIX/PWA]

Expand Down Expand Up @@ -238,7 +238,7 @@ Once you reserve your app name, you'll be automatically directed to the availabi

- **Packages**: Upload the app packages for your app which will be downloaded by the Store user. [Upload app packages - Windows apps | Microsoft Learn.](./publish-your-app/msi/upload-app-packages.md)

- **Store Listings**: Enter the app description, screenshots, and logos that will be displayed on your app’s Product Details Page (PDP) in the Store, by creating a Store listing. [Create app store listings - Windows apps | Microsoft Learn.](./publish-your-app/msi/create-app-store-listing.md)
- **Store Listings**: Enter the app description, screenshots, and logos that will be displayed on your app’s Product Details Page (PDP) in the Store, by creating a Store listing. [Create app store listings - Windows apps | Microsoft Learn.](./publish-your-app/msi/add-and-edit-store-listing-info.md)

2. After you complete a section, click on **Save**. Once all sections are complete and you are ready to submit, click on **Submit**.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ Note that some permissions cannot be set for add-ons. This is either because the
| **Properties** | Can view the <a href="../publish-your-app/msix/enter-app-properties.md">Properties</a> page of products. | Can view and edit the <a href="../publish-your-app/msix/enter-app-properties.md">Properties</a> page of products. | Can view the <a href="../publish-your-app/msix/enter-app-properties.md">Properties</a> page of add-ons. | Can view and edit the <a href="../publish-your-app/msix/enter-app-properties.md">Properties</a> page of add-ons. |
| **Age ratings** | Can view the <a href="../publish-your-app/msix/age-ratings.md">Age ratings</a> page of products. | Can view and edit the <a href="../publish-your-app/msix/age-ratings.md">Age ratings</a> page of products. | Can view the Age ratings page of add-ons. | Can view and edit the Age ratings page of add-ons. |
| **Packages** | Can view the <a href="../publish-your-app/msix/upload-app-packages.md">Packages</a> page of products. | Can view and edit the <a href="../publish-your-app/msix/upload-app-packages.md">Packages</a> page of products, including uploading packages. | Can view the <a href="../publish-your-app/msix/upload-app-packages.md">Packages</a> page of addons (if applicable). | Can view and edit <a href="../publish-your-app/msix/upload-app-packages.md">Packages</a> page of addons (if applicable). |
| **Store listings** | Can view the <a href="../publish-your-app/msix/create-app-store-listing.md">Store listing page(s)</a> of products.| Can view and edit the <a href="../publish-your-app/msix/create-app-store-listing.md">Store listing page(s)</a> of products, and can add new Store listings for different languages.| Can view the <a href="../publish-your-app/msix/create-app-store-listing.md">Store listing page(s)</a> of add-ons.| Can view and edit the <a href="../publish-your-app/msix/create-app-store-listing.md">Store listing page(s)</a> of add-ons, and can add Store listings for different languages.|
| **Store listings** | Can view the <a href="../publish-your-app/msix/add-and-edit-store-listing-info.md">Store listing page(s)</a> of products.| Can view and edit the <a href="../publish-your-app/msix/add-and-edit-store-listing-info.md">Store listing page(s)</a> of products, and can add new Store listings for different languages.| Can view the <a href="../publish-your-app/msix/add-and-edit-store-listing-info.md">Store listing page(s)</a> of add-ons.| Can view and edit the <a href="../publish-your-app/msix/add-and-edit-store-listing-info.md">Store listing page(s)</a> of add-ons, and can add Store listings for different languages.|
| **Store submission** | No access is granted if this permission is set to read-only. | Can submit the product to the Store and view certification reports. Includes both new and updated submissions. | No access is granted if this permission is set to read-only. | Can submit the add-on to the Store and view certification reports. Includes both new and updated submissions. |
| **New submission creation** | No access is granted if this permission is set to read-only.| Can create new <a href="../publish-your-app/msix/create-app-submission.md">submissions</a> for the product.| No access is granted if this permission is set to read-only. | Can create new <a href="../publish-your-app/msix/create-app-submission.md">submissions</a> for the add-on. |
| **New add-ons** | No access is granted if this permission is set to read-only. | Can <a href="../publish-your-app/msix/overview.md">create new add-ons</a> for the product. | N/A | N/A |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Note that your app must have at least one reserved name.

If your app is already in the Store and you want to rename it, you can do so by reserving a new name for it (by following the steps described above) and then creating a new submission for the app.

To update a Store listing so that it uses the new name, go to the [Store listing page](../../publish-your-app/msi/create-app-store-listing.md) for that language and select the name from the **Product name** dropdown. Be sure to review your description and other parts of the listing for any mentions of the name and make updates if needed.
To update a Store listing so that it uses the new name, go to the [Store listing page](../.././publish-your-app/msi/add-and-edit-store-listing-info.md) for that language and select the name from the **Product name** dropdown. Be sure to review your description and other parts of the listing for any mentions of the name and make updates if needed.

> [!NOTE]
> If your app has packages and/or Store listings in multiple languages, you'll need to update the packages and/or Store listings for every language in which the name needs to be updated.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Note that your app must have at least one reserved name.

If your app is already in the Store and you want to rename it, you can do so by reserving a new name for it (by following the steps described above) and then creating a new submission for the app.

To update a Store listing so that it uses the new name, go to the [Store listing page](../../publish-your-app/msix/create-app-store-listing.md) for that language and select the name from the **Product name** dropdown. Be sure to review your description and other parts of the listing for any mentions of the name and make updates if needed.
To update a Store listing so that it uses the new name, go to the [Store listing page](../../publish-your-app/msix/add-and-edit-store-listing-info.md) for that language and select the name from the **Product name** dropdown. Be sure to review your description and other parts of the listing for any mentions of the name and make updates if needed.

> [!NOTE]
> If your app has packages and/or Store listings in multiple languages, you'll need to update the packages and/or Store listings for every language in which the name needs to be updated.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,32 @@ ms.localizationpriority: medium

# Add and edit Store listing info for MSI/EXE app

## Create store listings for MSI/EXE app

The Store listings section of the app submission process is where you provide the text and images that customers will see when they view your app's listing in the Microsoft Store.

Many of the fields in a Store listing are optional, but we suggest providing multiple images and as much info as possible to make your listing stand out. The minimum required for the Store listings step to be considered complete is a text description and at least one screenshot.

> [!TIP]
> If you prefer to manage your store listing offline, you can [import a .csv file](./import-and-export-store-listings.md) that contains your app's details. Using the import and export option can be especially convenient if you have listings in many languages, since it lets you make multiple updates at once.

:::image type="content" source="images/msiexe-store-listings-overview.png" lightbox="images/msiexe-store-listings-overview.png" alt-text="A screenshot of the overview of Store listings section in Partner Center.":::

## Manage Store listing languages

You must complete the Store listing page for at least one language. We recommend providing a Store listing in each language that your packages support, and you also have flexibility to create Store listings in additional languages which are not supported by your packages and not support languages for which you do not wish to provide a Store listing.

To add or remove languages for your Store listings, click Add languages from Manage Store listings page.

:::image type="content" source="images/msiexe-listings-select-languages.png" lightbox="images/msiexe-listings-select-languages.png" alt-text="A screenshot of the Store listings section where you can add a language for listing your app in Microsoft Store.":::

When you have finished making your selections, click Save to return to the Manage Store listing page.

:::image type="content" source="images/msiexe-listings-language-added.png" lightbox="images/msiexe-listings-language-added.png" alt-text="A screenshot of the Store listings section showing a language has been added for listing.":::

The Manage Store listings page of the app submission process is where you can also publish your app. By default, we'll publish your submission as soon as it passes certification. As your submission passes certification, you can view certification status on the Application Overview page.


To edit a Store listing, select the language name from the Store listings overview page. You must edit each language separately.

:::image type="content" source="images/msiexe-listings-language-overview.png" lightbox="images/msiexe-listings-language-overview.png" alt-text="A screenshot of the Store listings section showing overview of details which need to be filled for Store listings.":::
Expand Down
32 changes: 0 additions & 32 deletions hub/apps/publish/publish-your-app/msi/create-app-store-listing.md

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Once you’ve exported your listings and saved your .csv file, you can edit your

Most of the Store listing fields are optional. The Description, one Screenshot, Store logo (1:1 box art) and Applicable license terms are required for each listing. For all other fields, you can leave the field empty if you don’t want to include it in your listing.

Many of the fields in your exported listings require text entry, such as the ones in the example above, Description and WhatsNew. For these types of fields, simply enter the appropriate text into the field for each language. Be sure to follow the length and other requirements for each field. For more info on these requirements, see [Create app Store listings](./create-app-store-listing.md).
Many of the fields in your exported listings require text entry, such as the ones in the example above, Description and WhatsNew. For these types of fields, simply enter the appropriate text into the field for each language. Be sure to follow the length and other requirements for each field. For more info on these requirements, see [Create app Store listings](./add-and-edit-store-listing-info.md).

Providing info for fields that correspond to assets, such as images, are a bit more complicated. Rather than Text, the Type for these assets is Relative path.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ You can make changes to a published app at any time. To submit updates, go to th

:::image type="content" source="images/msiexe-update-app.png" lightbox="images/msiexe-update-app.png" alt-text="A screenshot showing how to submit an update for EXE/MSI app.":::

Go to the required sections like [Pricing and availability](./price-and-availability.md), [Properties](./enter-app-properties.md), [Age ratings](./age-ratings.md), [Packages](./upload-app-packages.md) and [Store listing](./create-app-store-listing.md) to make the changes you'd like and save them. Then click  **Publish** on Manage Store listing page.
Go to the required sections like [Pricing and availability](./price-and-availability.md), [Properties](./enter-app-properties.md), [Age ratings](./age-ratings.md), [Packages](./upload-app-packages.md) and [Store listing](./add-and-edit-store-listing-info.md) to make the changes you'd like and save them. Then click  **Publish** on Manage Store listing page.

> [!NOTE]
>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Here are some tips for making your app's description the best it can be.
- **Use lists and short paragraphs.** Potential customers may just take a quick glance at your app's description. Breaking up the content by using short paragraphs and lists makes it easier to scan.

> [!NOTE]
>  Adding a list of [product features](create-app-store-listing.md) can also help to quickly show what your app does. This list appears directly below the app description.
>  Adding a list of [product features](./add-and-edit-store-listing-info.md) can also help to quickly show what your app does. This list appears directly below the app description.

- **Avoid dry language.** Write your description using engaging language. Be sure the wording clearly describes what your app does, but say it in a way that doesn't sound boring. For many apps, a casual and friendly tone works well.
- **Use a length that is just right.** A good description reads quickly, but also includes enough info to get the reader interested and explain what the app does. A complex app will need more sentences to describe it; a simple app may need only a few. In most cases the right length is somewhere over 200 words, but well under 3000.
Expand Down
Loading