App Store Listing Template

Boilerplate template for creating App Store Connect listings for hard-paywalled subscription apps. Based on the proven Mori (Stoic Death Clock) listing structure. Use the asc CLI to push listings to App Store Connect.

Required Fields

FieldLimitNotes
App Name30 charsBrand name + descriptor. Must match app.json
Subtitle30 charsKey value prop, keyword-rich
Keywords100 charsComma-separated, no spaces, no duplicates of name/subtitle words
Description4000 charsFeatures + subscription disclosure (REQUIRED for hard paywall)
What's New4000 charsRelease notes for each version
Support URLrequiredLink to support page
Privacy Policy URLrequiredLink to privacy policy

Description Structure (Hard Paywall Apps)

Apple requires subscription disclosure in the description for apps with auto-renewable subscriptions. Missing this = rejection.
Description Template
[APP NAME] is a [one-line value proposition].

[2-3 sentences expanding on what the app does and who it's for.]

Features include:
- [Feature 1]
- [Feature 2]
- [Feature 3]
- [Feature 4]
- [Feature 5]

[APP NAME] Pro subscription unlocks all features including [list key locked features]. A weekly subscription is available at [PRICE]/week. A lifetime purchase option is also available. Payment will be charged to your Apple ID account at confirmation of purchase. The subscription automatically renews unless it is canceled at least 24 hours before the end of the current period. Your account will be charged for renewal within 24 hours prior to the end of the current period. You can manage and cancel your subscriptions by going to your App Store account settings after purchase.

[Optional disclaimer if applicable, e.g., "not medical advice".]

Terms of Use: https://silpho.com/apps/[APP_SLUG]/terms
Privacy Policy: https://silpho.com/apps/[APP_SLUG]/privacy

The subscription disclosure paragraph covers: what the subscription unlocks, price, auto-renewal terms, how to cancel, and links to Terms & Privacy.

ASC CLI Commands

Create App in App Store Connect

asc apps create \
  --name "App Name" \
  --bundle-id "com.pawelkarniej.appslug" \
  --sku "com.pawelkarniej.appslug"

Set App Store Listing

asc apps info edit \
  --app "APP_ID" \
  --locale "en-US" \
  --description "Full description here..." \
  --keywords "keyword1,keyword2,keyword3" \
  --support-url "https://silpho.com/apps" \
  --whats-new "Initial release"

Set Subtitle

asc apps info edit \
  --app "APP_ID" \
  --locale "en-US" \
  --subtitle "Your Subtitle Here"

Reference: Mori (Approved & Live)

Mori: Stoic Death Clock is a live example of this template working in production. Keywords: memento mori,stoic,life calendar,weeks,countdown,quotes,widget,reflection,time,purpose

Mori Description (Approved)
Mori is a calm companion for philosophical reflection and intentional living.

See your life as a calendar in weeks, follow an approximate countdown, and return each day to carefully chosen Stoic quotes. With widgets and Live Activities, Mori keeps perspective close without demanding attention.

Features include:
- Life calendar in weeks
- Countdown and death clock
- Daily Stoic quotes
- Widgets and Live Activities
- WHO-based life estimate as a rough approximation

Mori Pro subscription unlocks all features including the life calendar, death clock, daily quotes, widgets, and Live Activities. A weekly subscription is available at $4.99/week. A lifetime purchase option is also available. Payment will be charged to your Apple ID account at confirmation of purchase. The subscription automatically renews unless it is canceled at least 24 hours before the end of the current period. Your account will be charged for renewal within 24 hours prior to the end of the current period. You can manage and cancel your subscriptions by going to your App Store account settings after purchase.

Mori is not medical advice and does not predict lifespan. The estimate is based on public WHO life-expectancy data and is meant only as a reflective tool.

Terms of Use: https://silpho.com/apps/memento/terms
Privacy Policy: https://silpho.com/apps/memento/privacy

Metadata Rules (Avoid Rejections)

Never mention AI provider names in metadata. Apple's China App Store review team rejects apps that reference ChatGPT, OpenAI, GPT, Claude, Anthropic, or Gemini in the title, subtitle, keywords, description, or screenshot captions. Use generic terms like "AI-powered" instead.
Do NOT useUse instead
"Powered by ChatGPT""AI-Powered"
"GPT-4 Technology""Advanced AI"
"Uses OpenAI""Smart AI Analysis"
"Claude AI""AI Assistant"

Avoid iPad screenshot requirements

If you don't explicitly support iPad layouts, set ios.supportsTablet: false in app.json. This prevents Apple from requiring iPad screenshots during submission.

app.json
{
  "expo": {
    "ios": {
      "supportsTablet": false
    }
  }
}

Subscription disclosure is mandatory

For hard-paywalled apps with auto-renewable subscriptions, the description MUST include: what the subscription unlocks, exact price, auto-renewal terms, how to cancel, and links to Terms & Privacy. Missing this results in rejection.

Approved in Production

Based on Mori — live on the App Store

Subscription disclosure template, ASC CLI commands, and keyword strategy included.

ASO-optimized titles
Subscription disclosure
ASC CLI ready
Get ShipReactNative
Save 40+ hours of setup