App Store, Note 04

Writing the store page for Sudoku: Color.

The real name, subtitle, keywords, description and screenshots, field by field, including where they've drifted from the app.

An App Store listing has two jobs that are easy to blur together. Some fields help the app get found. Others help someone who has found it decide to install. The listing for Sudoku: Color is written with that split in mind. This note walks through the actual listing, field by field, including the places where it's out of step with the app. We don't have conversion data to report, so this is about the reasoning, not results.

Name and subtitle: the two fields that matter most

The name is Sudoku: Color. The subtitle is Color Puzzle & Daily Challenge: exactly 30 characters, the limit.

Both are visible to people and both feed search, so they carry the core terms. "Sudoku" is the category a player already knows; "Color" is the difference; "Daily Challenge" names the feature that gives people a reason to come back. Because Apple already indexes the words in the name and subtitle, there's no reason to repeat them in the keyword field, and we don't.

The keyword field: 100 characters, no waste

The hidden keyword field is used to its full 100 characters, comma-separated with no spaces. It holds single words rather than phrases, because the store combines them itself. A few rules we follow:

  • No words already in the name or subtitle: no "sudoku", "puzzle", "daily" or "color".
  • Generic intent words a player might pair with sudoku: brain, logic, classic, relax, strategy.
  • A group of words for the newest feature: multiplayer, friends, online, versus. Online multiplayer is the clearest thing that distinguishes this sudoku from a plain one, so it earns the space.

The keyword field is the only part of the listing in English (U.S.) alone; other locales get translated subtitles, promotional text and descriptions.

The description is for people, not search

On the App Store the long description isn't used for search ranking, so it doesn't need to repeat keywords. Its job is to answer, quickly, "what is this and is it for me?" The structure is:

  • One line of hook: sudoku, but colorful.
  • How it works: the rules in two sentences, with the reassurance that it's the same logic as classic sudoku.
  • Four ways to play: New Game across five difficulties, Daily Challenge with its modifiers, Expert Mode, and Online Multiplayer.
  • Grouped features: palettes and themes, achievements and leaderboards, then the practical tools — auto-notes, conflict highlighting, sound and haptics, full game save.
  • The business model, plainly: free to play, with Remove Ads and the Nightmare Palette Pack as optional purchases.

Every feature named there exists in the app. That sounds obvious, but descriptions drift as features change, and a listing that promises something the app doesn't do costs more in reviews than it gains in installs.

Promotional text and What's New

Promotional text (up to 170 characters) sits above the description and can be changed without submitting a new build. It isn't used for search, so we use it purely to point at the newest thing — currently, that multiplayer is fully online, with rooms, matchmaking and rematches.

The What's New text for version 2.3 does the same job for existing players: online rooms and matchmaking, instant rematch, and the opponent's remaining lives shown during a race, followed by a short line of fixes.

Screenshots: where we found drift

The screenshot sets in the repository were captured in June for version 2.0. Each frame has one short headline — "Think in Color", "A New Challenge Every Day", "7 Palettes. Endless Color.", "For Every Skill Level" — over a real screen from the app: the board, the daily challenge picker, the palette settings, the difficulty list with its empty-cell counts.

Going back through them for this note turned up two mismatches worth fixing:

  • Achievement count. One frame says "68 Achievements to Unlock". The app and the description say 70. The screenshot predates the last achievements being added.
  • Multiplayer is missing. Version 2.3's headline feature doesn't appear in any screenshot. The description, promotional text and What's New all mention it; the images, which most people look at first, don't show it.

Neither is dramatic, but both are the kind of thing that happens to every listing that isn't reviewed against the app at each release. The fix is procedural: when a release changes a number or adds a mode, check the screenshots in the same pass as the description.

A checklist for your own listing

  • Put your most important terms in the name and subtitle, and don't repeat them in the keyword field.
  • Spend all 100 keyword characters: single words, commas, no spaces.
  • Write the description for a person deciding whether to install, and name only features that exist.
  • Use promotional text for whatever is newest; it can change between builds.
  • At every release, compare screenshots, description and app side by side. Numbers and new modes are where they drift.

Note details

SectionApp Store
Reading time4 min
UpdatedOctober 18, 2026

Questions about something in this note?

Send a message. If you're weighing a similar decision in your own app or tool, a short description of the problem is enough to start.