---
title: "What Is a Google Play Custom Store Listing? · Appy"
description: "A custom store listing is an extra version of your Google Play page for a country, an ad or a link. How the listing URL parameter works and what changes."
source: "https://appy.to/glossary/custom-store-listing"
---

1.  [Home](https://appy.to/)
2.  [Glossary](https://appy.to/glossary)
3.  Custom store listing

App stores

# What is a custom store listing on Google Play?

Short answer

A custom store listing is an alternative version of your Google Play store page, shown to a chosen audience instead of the default listing. You can create up to 50. Each can be targeted by country, by ad traffic, by user state or by a unique URL that ends in a listing parameter you name yourself.

Summarize with[ChatGPT](https://chatgpt.com/?q=Summarize%20this%20page%20and%20list%20its%20key%20points%3A%20https%3A%2F%2Fappy.to%2Fglossary%2Fcustom-store-listing) [Claude](https://claude.ai/new?q=Summarize%20this%20page%20and%20list%20its%20key%20points%3A%20https%3A%2F%2Fappy.to%2Fglossary%2Fcustom-store-listing) [Perplexity](https://www.perplexity.ai/search?q=Summarize%20this%20page%20and%20list%20its%20key%20points%3A%20https%3A%2F%2Fappy.to%2Fglossary%2Fcustom-store-listing)

## What you can change

Each custom store listing can have its own app name, icon, descriptions and graphics, including screenshots. Contact details, the privacy policy and the app category stay shared across all versions.

Your existing page becomes the default listing. People see it whenever no custom listing applies to them. Custom listings are not translated automatically, so add the languages your audience reads.

## How a listing is targeted

Google Play offers several ways to decide who sees a listing. Country targeting shows it to people in the places you pick, and a country can belong to only one custom listing at a time. Ads traffic shows it to people who arrive from a Google ad. User state options cover people who can pre-register, people who uninstalled the app and people who stopped opening it. A listing can also target specific search keywords.

The option that matters for links is the custom store listing URL. You type a parameter value when you create the listing, and Google Play serves that listing to anyone who opens the app’s link with listing= and that value on the end.

## The listing URL

The format is play.google.com/store/apps/details?id= plus the package name, then &listing= plus your value. The value has to be unique among your listings and can contain lowercase letters, digits, periods, hyphens, underscores and tildes.

This is Google Play’s counterpart to the custom product page on the App Store. The difference is in the ID: Apple generates a ppid for each page, while on Google Play you choose a readable value such as yoga or spring-sale.

A campaign that runs on both platforms needs both URLs behind one link. Create a smart link for the campaign, set the custom product page URL as the iPhone destination and the custom store listing URL as the Android destination. Appy accepts both and keeps ppid and listing as you pasted them.

If you also pass an install referrer, add it to the same URL as a separate referrer parameter. The two do different jobs: listing picks the page, referrer tells your app where the install came from.

ExampleCustom store listing URL

```
https://play.google.com/store/apps/details?id=com.example.app&listing=yoga
```

Try it here

## Build a store campaign link

Paste your App Store or Google Play link and add the campaign details. You get links that show up in App Store Connect and Play Console reports.

## App Store campaign link

Three values: your app, your provider token (pt) and a campaign name (ct). The builder adds mt=8 and encodes the rest.

App Store link or app ID

Your App Store page, or just the number after “id”. A link that already has pt= fills in the token too.

Custom product page ID (ppid)Optional

Paste the custom product page URL from App Store Connect, or just its ppid. Leave empty for your default page.

Provider token (pt)

Digits only. One number for your whole developer account.

Campaign token (ct)0 of 30 characters

This is the name you will see in App Store Connect.

No provider token yet?

1.  01In App Store Connect, open Apps, pick your app and go to Analytics. Under Acquisition, choose Campaigns and press +.
2.  02Make one campaign link there and copy the number after pt=. That is your provider token.
3.  03It stays the same for every campaign, so from now on you can build the links here.

Your App Store campaign link

Fill in all three fields to get the link.

The campaign shows up in App Store Connect at least 24 hours after launch, and only once five or more people have downloaded the app through it for the first time.

Copy link

## Google Play referrer link

Google Play reads campaign tags from one place: the referrer parameter. Fill in the UTMs and the builder encodes them into it.

Google Play link or package name

Your Play Store listing, or the id value from it.

Custom store listing (listing)Optional

The URL parameter you gave the listing in Play Console. Leave empty for your main store listing.

utm\_source

Where the click comes from.

utm\_medium

The kind of traffic.

utm\_campaign

Use the same name as your ct and the two reports line up.

Add utm\_term and utm\_content

utm\_termOptional

The paid keyword, if there is one.

utm\_contentOptional

Which ad or creative.

Your Google Play link

Add the app and the three required UTM fields to get the link.

Copy link

One link for both

### Put both behind one smart link

Share one short link instead of two. iPhones get the App Store campaign link, Android phones get the Google Play link, and the clicks are counted in one place.

-   iPhone and iPadNot set yet
-   AndroidNot set yet
-   ComputerNot set yet

Every Appy link comes with a QR code, so the same campaign works on a poster too.

Create my smart link

Free plan. No credit card.

What happens next

1.  01Sign up free with Google or email
2.  02We create the link with both stores
3.  03Share the link or download its QR code

[Read moreCustom Product Page and Custom Store Listing Links: Send Each Campaign to Its Own Store PageHow the App Store and Google Play page URLs work, how to use one link per campaign for both, and where to read the results.](https://appy.to/blog/custom-product-page-links)

## Frequently asked questions

### What is the listing parameter in a Google Play URL?

It selects a custom store listing. A link that ends in &listing=yoga opens the listing whose URL parameter is yoga. You choose the value in Play Console when you create the listing, and it must be unique across your custom store listings.

### How many custom store listings can an app have?

Up to 50 on Google Play. The App Store’s equivalent, the custom product page, allows up to 70 per app. On both stores the default page stays in place for everyone who is not sent to a custom version.

### What is the difference between a custom store listing and a custom product page?

They are the same idea on different stores. A custom store listing is Google Play’s version and is chosen by a listing value you name. A custom product page is the App Store’s version and is chosen by a ppid that Apple generates.

## Related terms

-   [Custom product page](https://appy.to/glossary/custom-product-page)

A custom product page is an extra version of your App Store product page with its own screenshots, promotional text and app previews. You can create up to 70 of them. Each has a unique URL with a product page ID, so ads and links can send people to the version that matches the campaign.

-   [App Store campaign link](https://appy.to/glossary/app-store-campaign-link)

An App Store campaign link is an App Store URL with three extra parameters, pt (provider token), ct (campaign token) and mt=8, so App Store Connect can report impressions, product page views, downloads and sales for each campaign. The numbers are aggregate: they show how a campaign did, not who installed.

-   [App store link](https://appy.to/glossary/app-store-link)

An app store link is the address of an app’s page in a store. On the App Store it looks like apps.apple.com/<country>/app/<name>/id<number>; on Google Play, play.google.com/store/apps/details?id=<package>. The scheme versions, itms-apps:// and market://, open the store app itself instead of a web page.


[All glossary terms](https://appy.to/glossary)

## One link for every phone

Create a free smart link and QR code that sends iPhones to the App Store, Android phones to Google Play and desktops to your website.

[Create a free link](https://appy.to/account/register)
