Using ms-windows-store URIs
This topic describes the ms-windows-store: URI scheme. Your app can use this URI scheme to launch the Microsoft Store app to specific pages in the store by using the LaunchUriAsync method on Windows 10 and Windows 11.
For example, you can open the Store to the Games page using the following code:
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));
Opening the Store to specific sections
You can launch the Store App to a specific page or section using the following options.
| URI Scheme | Description | Notes |
|---|---|---|
| ms-windows-store://home | Launches the home page of the Store. | |
| ms-windows-store://navigatetopage/?Id=[vertical] | Launches a top-level vertical page of the store | Verticals include: Home, Gaming, Entertainment, Productivity, and LOB, but note that available verticals can vary by region. |
| ms-windows-store://downloadsandupdates | Launches the downloads and updates page. | Starting with the October 2021 update to the Store app, this will launch the Library page. |
| ms-windows-store://settings | Launches the Store settings page. |
Opening to a specific product
You can launch the Store directly to the product detail page (PDP) for a specific product by using the Product ID for an App. While the Store app on Windows 10 and Windows 11 still supports Package Family Name (PFN) and App IDs, these are deprecated and may not be supported in the future. These values can be found in Partner Center on the App identity page in the Product management section for each app.
Starting with the October 2021 update to the Store app, there are two modes available for displaying the PDP. By default the Store app is opened to the product detail page. You can also launch the store into with a popup experience that displays a smaller PDP dialog with that only displays the essential details for your app and a single action button for users. For the popup experience, you can optionally specify the location of a window that the dialog should be centered above.
| URI Scheme | Description | Notes |
|---|---|---|
| ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL | Launches the full product details page (PDP) for a product | This is the recommended way to link to a specific product. |
| ms-windows-store://pdp/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe | Launches the full product details page (PDP) for a product | Using the package family name is deprecated. |
| ms-windows-store://pdp/?AppId=00001111-aaaa-2222-bbbb-3333cccc4444 | Launches the full product details page (PDP) for a product | Using the App ID is deprecated. |
| ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini | Launches the popup Store dialog experience | The popup experience only supports Product ID |
Launching the rating and review experience for a product
To enable users to review your app, you can link to that PDP and launch directly into the rating and review dialog. Store ID is the recommended method to launch the Store app to a specific product detail page.
| URI Scheme | Description | Notes |
|---|---|---|
| ms-windows-store://review/?ProductId=9WZDNCRFHVJL | Launches the write a review experience for a product. | Using StoreId is recommended |
| ms-windows-store://review/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe | Launches the write a review experience for a product. | Using product family name is deprecated. |
| ms-windows-store://review/?AppId=11112222-bbbb-3333-cccc-4444dddd5555 | Launches the write a review experience for a product. | Using productid is deprecated |
Searching the Store
You can launch the Store app directly into search results with several supported methods for searching store content.
| URI Scheme | Description | Notes |
|---|---|---|
| ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit, Camera_Capture_App | Launches a search for products associated with one or more tags. | Tags must be separated by commas. |
| ms-windows-store://search/?query=OneNote | Launches a search for the specified query. | Spaces in the query are allowed. |
| ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness | Launches a search for products in a category. | |
| ms-windows-store://publisher/?name=Microsoft Corporation | Launches a search for products from the specified publisher. | Spaces in the name are allowed. |
| ms-windows-store://assoc/?FileExt=pdf | Launches a search for products associated with a file extension. | |
| ms-windows-store://assoc/?Protocol=ms-word | Launches a search for products associated with a protocol. |