-
Essentials
-
Learning
-
Programs
-
Play Console
Test
Release
Grow
Quality
Monetize
Manage
Linking to Google Play
Build links that take users to your published apps in Google Play from browse or search.
Current as of Oct 24, 2023
Google Play provides several link formats that let you bring users to your products in the way you want, from Android apps, web pages, ads, reviews, articles, social media posts, and more.
The link formats let you link to the following:
- An app's store listing.
- A developer's page.
- A search result of your choice.
- A collection.
- A Google Play Instant experience.
Linking to store listing
Use the format below to deep-link directly to an app's Store listing page, where users can see the app description, screenshots, reviews and more, and then install it.
To create the link, you need to know the app's fully qualified package name, which is declared in the app's manifest file. The package name is also visible in the Google Play Console.
http://play.google.com/store/apps/details?id=<package_name>
Here’s an example:
https://play.google.com/store/apps/details?id=com.google.android.apps.maps
For details on how to send the link in an Android app, see Linking from an Android App.
Linking to a developer page
Use the format below to link users to your developer page. On this page you can provide more details about your brand, feature an app, and provide a list of other apps you've published.
To create the link, you need to know your publisher name, which is available from the Play Console.
http://play.google.com/store/apps/dev?id=<developer_id>
Here’s an example:
https://play.google.com/store/apps/dev?id=5700313618786177705
For details on how to send the link in an Android app, see Linking from an Android App.
Linking to a search result
Use the format below to link users to a search query result on Google Play. The search result page shows a list of apps (and optionally other content) that match the query, with ratings, badges, and an install button for each.
To create the link, you just need a search query string. If you want the query to search beyond the Google Play app listings, remove the &c=apps part of the link URL.
http://play.google.com/store/search?q=<search_query>&c=apps
Here’s an example:
https://play.google.com/store/search?q=maps&c=apps
For details on how to send the link in an Android app, see Linking from an Android App.
Linking to a collection
If your app is featured or appears in one of the Google Play top charts or collections, you can use the format below to link users directly to the collection. The collection shows a ranked list of apps in the collection, with ratings, short descriptions, and an install button.
http://play.google.com/store/apps/collection/<collection_name>
Here’s an example:
https://play.google.com/store/apps/collection/topselling_free
For details on how to send the link in an Android app, see Linking from an Android App.
Table 1.Collections on Google Play.
| Collection | collection_name |
|---|---|
| Staff Picks (Featured) | featured |
| Top Paid | topselling_paid |
| Top Free | topselling_free |
| Top New Free | topselling_new_free |
| Top New Paid | topselling_new_paid |
| Top Grossing | topgrossing |
| Trending | movers_shakers |
Linking to Editors' Choice Pages
If your app is featured or appears in articles in Editors' Choice, you can use the format below to link users directly to the Editors’ Choice page.
The URL for the main Editors' Choice page is:
https://play.google.com/store/apps/editors_choice
And you can find each page's URL from the Editors' Choice page.
Here are some examples:
Linking from an Android App
If you want to link to your products from an Android app, create an Intent that opens a URL. As you configure this intent, pass 'com.android.vending' into Intent.setPackage() so that users see your app's details in the Google Play Store app instead of a chooser.
The following example directs users to viewing the app containing the package name com.example.android in Google Play:
Kotlin
Java
val intent = Intent( Intent.valACTION_VIEW).apply {
data = Uri.parse(
\"https://play.google.com/store/apps/details?id=com.example.android\")
setPackage(\"com.android.vending\")
}
startActivity(intent)
Intent intent = newIntent(Intent.ACTION_VIEW);
intent.setData(Uri.parse(
\"https://play.google.com/store/apps/details?id=com.example.android\"));intent.setPackage(\"com.android.vending\");
intent.setPackage(\"com.android.vending\");
startActivity(intent);
Launching a Google Play Instant experience
If you have published an instant app using Google Play Instant, you can launch the app as follows:
Kotlin
Java
val uriBuilder = Uri.parse(\"https://play.google.com/store/apps/details\")
.buildUpon()
.appendQueryParameter(\"id\",\"com.example.android\")
.appendQueryParameter(\"launch\",\"true\")
// instant app. You can retrieve these parameters using Activity.intent.data.
uriBuilder.appendQueryParameter(\"referrer\",\"exampleCampaignId\")
val intent = Intent(Intent.ACTION_VIEW).apply {
data =uriBuilder.build()
setPackage(\"com.android.vending\")
}
startActivity(intent)
Intent intent = new Intent(Intent.ACTION_VIEW);
Uri.Builder uriBuilder =Uri.parse(\"market://launch\")
.buildUpon()
.appendQueryParameter(\"id\",\"com.example.android\");
// Optional parameters, such as referrer, are passed onto the launched
// instant app. You can retrieve these parameters using
// Activity.getIntent().getData().
uriBuilder.appendQueryParameter(\"referrer\",\"exampleCampaignId\");
intent.setData(uriBuilder.build());
intent.setPackage(\"com.android.vending\");
startActivity(intent);
Note: If Google Play Instant isn't enabled on the device, the store listing is shown.
Summary of URL formats
The table below provides a summary of the URIs currently supported by the Google Play (both on the web and in an Android application), as discussed in the previous sections.
| For this result | Use this link |
|---|---|
| Show the store listing for a specific app | https://play.google.com/store/apps/details?id=<package_name> |
| Show the developer page for a specific publisher | https://play.google.com/store/apps/dev?id=<developer_id> |
| Show the result of a search query | https://play.google.com/store/search?q=<query> |
| Show an app collection | https://play.google.com/store/apps/collection/<collection_name> |
| Launch a Google Play Instant experience | market://launch?id=<package_name> |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2023-03-08 UTC.
More brand & marketing resources
-
Google Play icon design specifications
Design guidelines, templates, and examples for creating app icons for the Google Play Store.
-
Google Play badges
Build badges for your app in just a few clicks and download hi-res badge assets localized for a variety of languages.
-
Device art generator
Drag and drop screenshots of your app into device artwork for better looking promotional images and improved visual context.
Guides
-
Brand guidelines
The "Android" name, the Android logo, the "Google Play" brand, and other Google trademarks, are property of Google LLC and not part of the assets available through the Android Open Source Project.
-
Google Play icon design specifications
Apps & Games on Google Play are adopting a new icon system to better fit diverse developer artwork to Google Play's various UI layouts, form factors, and devices, as well as to bring consistency and a cleaner look to Google Play.
-
Google Play badges
Google Play badges can be used in marketing campaigns to promote content on Google Play.
-
Device art generator
Quickly wrap app screenshots in device artwork with this device art generator. The resulting artwork provides better visual context for your app screenshots on your website or in other promotional materia