Guide
Custom Product Pages for Search Keywords: How to Assign Them
You can assign keywords to a custom product page so that page, rather than your default product page, can appear in App Store search for those keywords. Apple's advice is short: choose keywords that match the intent of the page, and make each keyword combination unique to a single product page. Up to 70 custom product pages can exist per app.
Updated
What Apple documents
- A custom product page can have its own screenshots, previews, promotional text and keywords, can be localized and has its own unique URL.
- It is visible only through its link, or in search if keywords are assigned to it. Otherwise the default product page is shown.
- Each keyword combination must be unique to a single product page.
- Custom product pages require iOS 15 or iPadOS 15 or later and must be approved by App Review before they are visible. Their metadata can be submitted independently of an app update.
- While a page is under review, its screenshots, previews, promotional text and keywords cannot be modified; withdrawing the submission makes it editable again.
- Metrics appear in App Analytics after a page receives at least five first-time downloads.
- Apple states developers see a 2.5 percentage point conversion increase on average when referring people to a custom product page, compared with 1.6% on default pages. That average comes from referred traffic, not from search, so do not expect it for a keyword.
Apple's pages, as read for this guide, do not say how custom page keywords relate to the 100-byte keyword field. Do not assume they share or add to that budget; check the limits in App Store Connect before you plan.
Steps
- Find keywords with a clear intent split. The same app is searched for different reasons. A person typing a running-related term wants running features. See keyword research for finding them.
- Write one page per intent. Each page leads with the matching screenshot, promotional text and, if useful, a preview. The default page stays the general pitch.
- Assign keywords that match that intent only. If a keyword fits two pages, pick one. Apple requires each combination to be unique to a page.
- Localize the pages for the storefronts where those keywords matter. A page and its keywords are per language.
- Submit for review early. Pages need App Review approval, and you cannot edit while they are under review.
- Measure after five downloads. Apple shows metrics only after at least five first-time downloads. Compare conversion per page, not just downloads.
- Retire or merge weak pages. If a page never reaches meaningful volume, fold its keywords into a stronger page.
Worked example
A hypothetical habit tracker, Streakly, has three intents in its keyword research: running habits, study habits and meditation habits. It builds three custom pages beside the default one, so four pages in total, well under the limit of 70.
| Page | Lead screenshot | Keywords assigned |
|---|---|---|
| Default | Streak chart overview | none |
| Running | Weekly run streak | running habit, run streak |
| Study | Daily study timer | study routine, study streak |
| Meditation | Calm reminder screen | meditation habit, mindful routine |
No keyword appears on two pages. "Streak" alone is not assigned anywhere because it fits all three, so it stays with the default page. Each keyword has more than two characters, as Apple requires for the keyword field.
For time-limited themes, see seasonal keywords.
Pitfalls
- Keywords that overlap. Two pages competing for the same combination breaks Apple's uniqueness rule.
- Mismatch. A page that does not show what the keyword promises will convert poorly, and Apple frames the keyword-to-intent match as the condition.
- Skipping a pre-test. The same unique URLs can be used in Apple Ads campaigns, so you can check how a page converts with paid traffic before you rely on it for search.
Next step
Plan the default metadata first with the keyword field guide. LocalASO tracks keyword rank and difficulty in 52 storefronts, which helps you see which intents are worth a page; see the keyword research docs.
Sources
- Apple: developer.apple.com/help/app-store-connect/create-custom-product-pages/configure-multiple-product-page-versions (checked November 1, 2026)
- Apple: developer.apple.com/app-store/custom-product-pages (checked November 1, 2026)
- Apple: developer.apple.com/app-store/search (checked November 1, 2026)
- Apple: developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/submit-a-custom-product-page (checked November 1, 2026)
- Apple: developer.apple.com/help/app-store-connect/reference/platform-version-information#keywords (checked November 1, 2026)
Do this for every country, in minutes