How do keywords work on custom product pages?
Updated 14 November 2026
You can assign keywords from your latest approved app version to a custom product page, and it then shows in search for those keywords instead of your default page. You get up to 70 pages per app. In our test the list held only words from the keyword field, not the name or subtitle, and repeating a name word in the keyword field made it available.
What Apple documents
- Up to 70 custom product pages per app.
- Each page can vary screenshots, promotional text and app previews, per localization. You start from a blank page or a copy of the default.
- Keywords: "You can assign keywords from your latest approved app version to a custom product page." The page then appears in search for them instead of the default page.
- Each keyword combination must be unique to a single product page.
- The page is searchable only after it is approved and set to visible.
- Page metadata is reviewed on its own, without an app update.
What we found
We tested on one of our widget apps in November 2026. Two angles agreed.
| Test | Result |
|---|---|
| Which keywords the page can pick, read through the API | Exactly the words in the keyword field. Words that live only in the name were not there |
| A word in both the name and the keyword field (Traditional Chinese listing) | Offered, assigned through the API, read back. Apple approved the page |
That means the main search you put in the name, the one your default page serves, cannot get its own page unless you also write it into the keyword field. Pages are for the second-tier intents: a feature, a use, a platform word.
What we did not find out
We do not know how Apple matches a longer search to a single assigned word, and App Store Connect does not report keyword-level data for pages. You see page views, not which keyword produced them. Which page Apple shows for a repeated name word was still open when we wrote this.
How to set one up
- Put the second-tier searches in the keyword field of the version you ship. See what to put in the keyword field.
- Wait for that version to be approved.
- Create a page, open its Keywords section for each localization and pick a set no other page uses.
- Make it visible and submit it for review.
Screenshots do not copy over from the default version. Upload them for the page yourself. Lazy ASO shows which searches are worth a page, with Apple's official popularity next to each. Try the free name check first.