Linking to your app
You can help customers discover your app by linking to your app's web-based listing page. If the user is on Windows 8 or Windows 8.1, you can provide a link directly to your app's listing page in the Windows Store.
When your app is published into the Windows Store, a web version of your app listing page is automatically created in all markets where your app is available, and in all languages in which you've provided localized description content. These web-based listings provide an opportunity for users on any platform to learn more about your app. They are the best way to share a link to your app through email or social networks, even if you don’t know what platform your audience is on.
The web listing surfaces the content you submitted for your app's listing, including its description, screenshots, price, and average star rating. This makes the data available to be indexed by web search engines and makes your app easier for users to discover.
In most cases, if a customer running Windows 8 or Windows 8.1 clicks a link to a web-based listing page, the Windows Store will launch and display the app's listing in the Store. The web page will also launch in the customer's browser, with a View in Windows Store button displayed.
To access the web link to your app
- Sign in to your Windows Store Dashboard.
- Click the Details link on the app tile under the Apps in the Store section.
- Scroll down to the section entitled Link to yourappname.
Internet Explorer provides additional ways to connect your web site to your app. To learn more, read:
You can create a link that goes directly to your app's listing page in the Windows Store. These links are useful if you know your user is on Windows 8 or Windows 8.1 and you want them to arrive directly at the listing page in the Store. For example, after checking user agent strings in a browser to ensure the user is running Windows 8 or Windows 8.1, or when you are already communicating via a Windows Store app, you’ll know you can apply this protocol. Up-to-date versions of Internet Explorer, Safari, and Firefox all support these protocols.
To create the Windows Store protocol link, append the Package Family Name of your app to the URL:
You can retrieve the Package Family Name for your app either from Microsoft Visual Studio, or by visiting your app’s web-based listing page and viewing the page source.
You can also link to your Publisher page by using the following syntax:
ms-windows-store:Publisher?name=[your publisher display name]
Note Any spaces in your publisher name should be rendered as
When the Store receives a protocol request, it displays the appropriate page of the Store. The Store maintains navigation history and state, just as it does for a user action.
The Store will reject protocol requests that don’t match one of the supported actions or that have invalid or missing parameters. For requests that are properly formatted but result in an inaccessible page, the Store will display an error page.
Here are the actions you can use with the Windows Store protocol.
|PDP||Opens an app's listing page.||PFN: the Package Family Name of the application|
|Review||Opens the "Write a review" page of an app's listing.||PFN: the Package Family Name of the application|
|Publisher||Opens the page displaying all apps from a publisher.||name: the publisher display name|
|Search||Executes a search query and displays the results.||query: the query to issue to the Store|
|Updates||Opens the Store's updates page.||None|