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

What we found

We tested on one of our widget apps in November 2026. Two angles agreed.

TestResult
Which keywords the page can pick, read through the APIExactly 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

  1. Put the second-tier searches in the keyword field of the version you ship. See what to put in the keyword field.
  2. Wait for that version to be approved.
  3. Create a page, open its Keywords section for each localization and pick a set no other page uses.
  4. 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.

Stop guessing names

$9 a month or $59 a year, each with a 7-day free trial (card required, cancel before day 7 and pay nothing), or $129 once. Full refund within 14 days of your first purchase.

Buy Lazy ASO