Storeboard

Storeboard/Blog/App Store keywords

App Store keywords: how the 100-character keyword field really works (with examples)

Keywords By Sanket Singh · 3 November 2026 · 13 min read

App Store keywords cover: Hydration Hero's real name and subtitle, a 100-character keyword field made of comma-separated words, and Storeboard's Opportunity and rank chips for each word

The App Store keyword field is a hidden list of up to 100 characters of comma-separated terms that Apple matches, along with your app name, subtitle and category, to decide which searches your app shows up for. Fill it with words that aren't already in your name, subtitle or category, separate them with commas and no spaces, and leave out plurals, filler words and anyone else's app name. Below are Apple's actual rules (with links), a real before-and-after from one of my own apps, and the storefront table that tells you which extra localizations count where you sell, and how I let a coding agent do the keyword legwork through Storeboard's MCP server.

Checked against Apple

Every rule here comes from Apple's own pages, opened on 3 November 2026: App Store search, Creating your product page and the App Store Connect Help reference. Where Apple doesn't say something, I say so.

Summary card of the App Store keyword field: up to 100 hidden characters of comma-separated terms; only words not already in your name, subtitle or category; commas with no spaces, such as water,habit,sip; and no plurals, filler words or other apps' names.
The whole answer before the detail: four rules from Apple's own pages.

On this page

  1. Where does the App Store get keywords from?
  2. What are the rules for the 100-character field?
  3. What does a real keyword field look like, before and after?
  4. How do extra localizations give you more keywords?
  5. How do you choose which keywords to use?
  6. How do you track rankings and when should you change keywords?
  7. Can an AI agent manage my App Store keywords through MCP?
  8. What are the most common keyword field mistakes?
  9. Questions

Where does the App Store get keywords from?

Apple's search page says results depend on text relevance, meaning "matches for your app's title, subtitle, keywords, and primary category", plus user behavior such as downloads, ratings and reviews. It also says your primary and optional secondary category are indexed, and App Store Connect notes that your app is searchable by app name and company name.

FieldLimitWhat Apple says about search
App name30 charactersMatched in search
Subtitle30 charactersMatched in search
Keyword field100 characters (Apple also says 100 bytes)Matched in search; not shown on your product page
Primary and secondary categoryChosen from Apple's listIndexed
Company (developer) name—Searchable
Description4,000 characters"Don't add unnecessary keywords to your description"
Promotional text170 characters"Doesn't affect your app's search ranking"
Four cards showing the text App Store search matches: app name, 30 characters; subtitle, 30 characters; keyword field, 100 characters and not shown on your product page; and primary and secondary category, which are indexed. Below them: the 4,000-character description and 170-character promotional text don't help ranking.
Name, subtitle, keywords and category are what search matches. Only the keyword field is invisible.

Two newer things also show up in search. Promoted In-App Purchases and In-App Events can appear in results, and you can now assign keywords to a custom product page so it appears for those searches instead of your default page. Apple asks that each keyword combination belongs to only one product page.

So the keyword field is one of four text sources, and the only one nobody sees. That's why it's the easiest place to waste.

Three cards: Promoted In-App Purchases and In-App Events can appear in App Store search results, and custom product pages can be assigned keywords so they appear for those searches instead of your default page, with each keyword combination belonging to only one page.

What are the rules for the 100-character keyword field?

Here's everything Apple says, grouped. Quotes are Apple's words.

Format

Format rules for the keyword field: write water,habit,sip with commas and no spaces rather than water, habit, sip; phrases such as Property,House,Real Estate are allowed; each keyword must be longer than two characters; the total stays within 100 characters.

Don't repeat what Apple already has

Don't break the rules

Apple says "improper use of keywords is a common reason for App Store rejections", and lists what not to include: unauthorized trademarks, celebrity names and other protected words, terms that aren't relevant to the app, competing app names, and inappropriate or offensive terms.

One thing Apple doesn't spell out is how it combines words from different fields into multi-word searches, or how much weight each field gets. Treat anyone who quotes exact weights with suspicion, including me.

Six cards of what to leave out of the keyword field: unauthorized trademarks, celebrity names and other protected words, terms not relevant to the app, competing app names, inappropriate or offensive terms, and words repeated from your name, subtitle or category including plurals such as climb and climbs.
Apple lists these as things not to include; competing app names are the easiest to add by accident.

What does a real keyword field look like, before and after?

Here's one of my apps, Hydration Hero. Its current US listing (checked 3 November 2026) is:

So these words are already covered before the keyword field starts: hydration, hero, water, reminder, coffee, drinks (and drink, since plurals are duplicates), tracker, health, fitness and lifestyle.

Chips listing the words Hydration Hero's US name, subtitle and categories already cover, so they don't belong in its keyword field: hydration, hero, water, reminder, coffee, drinks, drink, tracker, health, fitness and lifestyle.

The "before" field below is the one in the Hydration Hero project shown in Storeboard's App Store screenshots. That project uses an earlier app name, so it's a fair picture of a field that was written and then left alone while the name and subtitle changed around it.

Before · 94 of 100 characters

reminder,fitness,tracker,habit,hydration tracker,coffee tracker,sip,[another app's name] - hydration coach

Result: 2 new words (habit, sip) from 94 characters. The rest repeats the name, subtitle or category, and one term is a competing app's name, which Apple doesn't allow.

I've hidden the other app's name on purpose. It's exactly the kind of term Apple says can get an update rejected, and it's easy to add without thinking when you see a competitor ranking for your words.

Here's the rewrite I'd test. Every word comes from features listed in Hydration Hero's own App Store description (avatar, goals, streaks, badges, challenges with friends, custom drinks, and tracking the effect of caffeine and alcohol), and none repeats the name, subtitle or category.

After · 96 of 100 characters · 14 new words

intake,goal,habit,sip,avatar,caffeine,beverage,streak,challenge,friends,log,herbal,alcohol,badge

No spaces, no repeats, no plurals of words already used, nothing from another app. Whether it ranks better is something to measure, not assume.

Two things to notice. First, "hydration tracker" doesn't need to be in the keyword field at all: both words are already in the name and subtitle. Second, the rewrite has no phrases. Apple allows them, but every space inside a phrase is a character, and each word here is already doing its own job.

Storeboard's keyword field editor for Hydration Hero in the United States storefront, with an Opportunity score and current rank shown for each word: reminder, fitness, tracker, habit and hydration tracker
How Storeboard shows the same field: each word gets an Opportunity score and your current rank in the chosen storefront (a real screen from Storeboard's App Store listing).

How do extra localizations give you more keywords?

Each localization in App Store Connect has its own keyword field, and a storefront can support more than one language. Apple's localization help puts it like this: if you localize into French, "users can search for your app using localized keywords in all countries or regions where the App Store supports French."

Apple's App Store localizations table lists the languages each storefront supports. Some rows, as of 3 November 2026:

StorefrontDefault languageAdditional supported languages
United StatesEnglish (US)Arabic, Chinese (Simplified), Chinese (Traditional), French, Korean, Portuguese (Brazil), Russian, Spanish (Mexico), Vietnamese
United KingdomEnglish (U.K.)None listed
AustraliaEnglish (Australia)English (U.K.)
New ZealandEnglish (Australia)English (U.K.)
CanadaEnglish (Canada)French (Canada)
IndiaEnglish (U.K.)Bangla, Gujarati, Hindi, Kannada, Malayalam, Marathi, Odia, Punjabi, Tamil, Telugu, Urdu
Storefront cards from Apple's localizations table: the US supports Spanish (Mexico) among its extra languages, Australia and New Zealand support English (U.K.) alongside English (Australia), the United Kingdom lists no additional language, and Canada supports French (Canada) alongside English (Canada).
Each supported language is another keyword field searches in that storefront can match.

What that means in practice:

A caution before you stuff a second locale: it isn't hidden. Its name, subtitle and description are what people using that language can be shown, so a page of English keyword-bait labeled Spanish is a bad look. Fill it with a real translation, then use its keyword field for that audience's words. Apple doesn't document how a secondary language's keywords are weighted against the default one.

Three steps for a second localization: give it a real translation because its name, subtitle and description can be shown to people using that language, then use its keyword field for that audience's words; Apple doesn't document how its keywords are weighted against the default language.

If you sell in several English-speaking countries, the English keywords by country guide covers how to split vocabulary between them.

How do you choose which keywords to use?

Apple's own advice is a trade-off: popular terms like "jobs" or "social" bring traffic but are "highly competitive – especially if you are a newer or smaller app", while less common terms "drive lower traffic, but are less competitive." For a small app, the second group is usually where you can actually rank.

To make that call you want three numbers per word, in the storefront you sell in: how often people search it (popularity), how strong the apps ranking for it are (difficulty), and the gap between the two (opportunity). Storeboard: ASO Assistant shows all three per storefront on your Mac, plus who ranks for each term now, uses Apple's own popularity figure when your Apple Ads account is linked, and has a coverage view that flags wasted characters in every language's name, subtitle and keyword field. The free keyword check by country does a single term in the browser, and the keyword research guide walks through a full workflow.

Three cards explaining popularity as how often people search a word, difficulty as how strong the apps ranking for it are, and opportunity as the gap between the two, above a real Storeboard keyword field showing an Opportunity score and rank for each word.
For a small app, less common, less competitive terms are usually where you can rank.

How do you track rankings and when should you change keywords?

Apple points you to App Analytics in App Store Connect: impressions, conversion rate and downloads, filtered by source type so you can see what came from App Store search. Your Apple Ads results show up there too, so separate them before you judge a keyword change.

Because keywords belong to an app version, you change them when you ship an update. My approach:

  1. Change a few words per release, not the whole field, so you can tell what worked.
  2. Note your ranks for the words you removed and added before you submit.
  3. Compare search impressions and ranks after the update has been live for a while, then keep or swap.
Three-step loop for keyword changes: change a few words per release rather than the whole field, note your ranks for the words removed and added before you submit, then compare search impressions and ranks after the update has been live for a while.

Storeboard: ASO Assistant records keyword trends on your Mac, and Pro's performance tracking reads your downloads, impressions and conversion through an App Store Connect API key, so you can see whether a keyword change moved anything. It doesn't keep a server-side archive of daily ranks. If you need that across hundreds of terms, pair it with a dedicated tracker; I compare one in Storeboard vs Astro.

Can an AI agent manage my App Store keywords through MCP?

It can do most of the legwork. I make Storeboard, a native Mac app that manages your whole App Store presence: screenshots and other media, listing metadata, keywords, coverage, performance and competitors, published to App Store Connect. It runs a local MCP server, so you can work the keyword field yourself or let your coding agent (Claude Code, Cursor or Codex) do it.

For keywords, the Coverage tab is where an agent earns its keep. It shows, language by language, how much of the name and subtitle keyword space is used, and I personally let the agent handle most of it. Because the agent sees the whole project, you can also ask it how your keywords did over the last 7 days, or whether conversion is up or down and why.

Real frames from the Storeboard demo: the Media, Listing, Keywords, Coverage, Performance and Competitors tabs a coding agent can work across, the agent's panel reporting it used Storeboard and is applying the English headline in all 38 languages, and an example mock-up of the Storeboard window with a placeholder search image updating from English (US) to all 38 languages.
Real frames from my demo video: the agent works in the same project and tabs you do, through Storeboard's MCP server.

A real example from my demo, on the visual side of the listing: I asked my agent to update my App Store search image. It wrote the English (US) headline first, then applied it to the other languages; in the demo, the agent applied it to all 38 languages. It also kept another company's brand name out of the image, the same rule Apple applies to the keyword field. AI translation is a best guess, a pretty decent job, but a native speaker is better.

Two real Storeboard screens from the demo: Settings on the Agents tab, where you connect Claude Code, Cursor or Codex, and the Publish to App Store Connect dialog with header and search images selected, with three steps between them: connect your agent, the agent edits and every change can be undone, you publish.
You review what the agent changed, then publish to App Store Connect yourself.

Storeboard isn't headless. Every change shows in the app, you can click through each language and undo with ⌘Z, and agents can't publish. You choose what goes to App Store Connect and for which locales, with your own API key, and new keywords still ship with an app version. Get Storeboard on the Mac App Store or watch the 8-minute demo.

Play button over a real frame of the Storeboard demo video, showing Storeboard's Settings open on the Agents tab. Opens the 8-minute demo on YouTube.
Watch the 8-minute demo on YouTube: my agent updates the search image through Storeboard's MCP server, then I publish to App Store Connect.

What are the most common keyword field mistakes?

The free Keyword Field Counter catches the first three: paste your name, subtitle and keywords and it shows repeated words and wasted characters.

Check your field, then research where you sell

Run your listing through the free Keyword Field Counter. Then score each word's popularity, difficulty and opportunity in your own storefront with Storeboard: ASO Assistant, free on the Mac App Store.

Open the Keyword Field Counter Download Storeboard free

Questions

How many characters is the App Store keyword field?

100 characters, which Apple's documentation also describes as 100 bytes. Apple's App Store search and product page guidance says keywords are limited to 100 characters total, and the App Store Connect reference says up to 100 bytes of content. For English and other unaccented Latin-script text these are the same. Apple doesn't say how it counts scripts such as Japanese, Chinese, Korean, Arabic or Russian, where a character takes more than one byte, so check what App Store Connect accepts before relying on 100 characters in those languages.

Do spaces count in the App Store keyword field?

Yes. Every character counts toward the 100, including spaces. Apple asks for terms separated by commas with no spaces, so a space after a comma is a wasted character. A space inside a phrase, like Real Estate, is allowed.

Should I use singular or plural keywords?

Use one form only. Apple's App Store search guidance says plurals of words you've already included, such as climbs and climb, are considered duplicates, so adding both spends characters for nothing.

Can I use competitor app names as keywords?

No. Apple lists competing app names, unauthorized trademarks and celebrity names among the things you must not put in your keywords, and says improper keyword use is a common reason for App Store rejections.

Does the app description help App Store search?

Not according to Apple's search guidance, which lists text relevance as matches for your app's title, subtitle, keywords and primary category. Apple also says not to add unnecessary keywords to your description, and that promotional text doesn't affect search ranking. Write the description for people.

Can an AI agent write my App Store keywords?

It can do the research and the edits. Storeboard runs a local MCP server on your Mac, so a coding agent such as Claude Code, Cursor or Codex can read your keyword, coverage and performance data and edit the keyword field in every language. You review each change in the app and publish to App Store Connect yourself. Apple's keyword rules still apply, so check what it writes.

Can I change my keywords without a new app version?

In practice, no. Keywords sit with the app version's information in App Store Connect, so you change them when you submit a new version. Promotional text is the field you can change any time, but it doesn't affect search.

Sources

Apple pages read on 3 November 2026 (Melbourne time).

Keep reading