Publish your Progressive Web App to the Microsoft Store

Publishing your Progressive Web App (PWA) to the Microsoft Store brings the following advantages.

Discoverability

Users naturally look for apps in the app store. When you publish to the Microsoft Store, millions of Windows users can discover your PWA alongside other Windows apps. The Store showcases apps through categories, curated collections, and more. The app discovery portals provide an easy browsing and shopping experience for potential users of your app. You can even enhance your Store listing with screenshots, a hero image, and video trailers.

Trustworthiness

Windows customers know they can trust their Microsoft Store purchases and downloads, because they adhere to the rigorous Microsoft quality and safety standards.

Easy install

The Microsoft Store provides a consistent and user-friendly install experience across all Windows 10 or later apps.

App analytics

The Windows Partner Center dashboard provides you with detailed analytics about your app health, usage, and more.

To publish your PWA to the Microsoft Store, no code changes are required. Instead, you create an app reservation, package your PWA, and submit your package to the Store. The following sections explain the steps.

Create an app reservation

Windows Partner Center is the hub for you to submit your app to the Microsoft Store.

To create an app reservation:

  1. To display your enrolled programs:

    1. Sign into Windows Partner Center with your Microsoft account and go to the Partner Center Dashboard.
    2. Navigate to Windows & Xbox.
      • If Windows & Xbox is displayed, your app is already enrolled.
      • If Windows & Xbox isn't displayed, select Add program.

    Add a program in the Windows Partner Center dashboard.

  2. To enroll in the developer program:

    1. Navigate to Windows & Xbox.
    2. Select Get started.
    3. Follow the prompts.
  3. Now, your account is enrolled in the app developer program. To create an app reservation:

    1. Navigate to Windows & Xbox.
    2. Select Overview > Create a new app.
    3. Type the name of your app in the prompt.
    4. Select Reserve product name.

    Create an app reservation in Windows Partner Center.

  4. To display your publisher details for use in the Package your PWA section, select Product management > Product Identity.

    Copy your publisher information from Windows Partner Center.

  5. Copy and save the following values.

    • Package ID
    • Publisher ID
    • Publisher Display Name

Package your PWA for the Store

Now that you have your app publishing information, generate a Windows app package for your PWA.

To generate an app package:

  1. Go to PWA Builder.

  2. Type the URL of your PWA and click Start.

  3. Once your report is complete, make sure your PWA is store-ready. If your PWA score is too low, you can visit the Manifest Options and Service Worker Options and check out the sections that need work.

  4. When your PWA is ready to be published, click Next, and then select the Store Package button in the Windows section of the publish page.

  5. Paste the following values, which you saved in the Create an app reservation section:

    • Package ID
    • Publisher ID
    • Publisher Display Name

    Paste publisher information into PWABuilder.

  6. Select Generate.

  7. To download your Windows app package, select Download.

Your download is a .zip archive that contains an .msixbundle file and a .classic.appxbundle file. The two app packages allow your PWA to run on a wide variety of Windows versions. For more information, see What is a classic package?.

Submit your app package to the Store

To submit your app to the Store:

  1. Go to Windows Partner Center

  2. Select your app.

  3. Select Start your Submission.

    Start a new app submission on Windows Partner Center.

  4. When you are prompted, provide information about your app, such as pricing and age rating.

  5. On the Packages prompt, select the .msixbundle and the .classic.appxbundle files you generated in the Package your PWA section.

After you complete your submission, your app is reviewed, typically within 24 to 48 hours. After you receive approval, your PWA is available in the Microsoft Store.

Measure usage of your Store-installed PWA

When your PWA is initially launched, if the PWA was installed from the Microsoft Store, Microsoft Edge includes the following Referer header with the request for the first navigation of your web app.

Referer: app-info://platform/microsoft-store

Use this feature to measure distinct traffic from your Store-installed PWA. Based on the traffic, you can adjust your app’s content to improve the user experience. This feature is accessible to both client and server code. To access this information on the client side, you can query document.referrer in your JavaScript.

This feature was first introduced in Microsoft Edge version 91, and the DOM API was introduced in Microsoft Edge version 93.

See also