---
title: Edit Listing Text
description: Edit your title, subtitle, description, keywords, and release notes in the draft, one field at a time, with per-store character limits enforced.
---

The Listing Text editor is where you write the text of your listing — title, subtitle, description, and the store-specific fields. Each field is its own tab, and everything you save lands in the draft for the store you're editing, never on the live listing.

## Before you start

- Your project needs a linked store or imported store text so there's a listing to edit. See [App Store linking](/docs/store-setup/appstore-credential) or [Google Play linking](/docs/store-setup/playstore-credential).
- Editing the **Keyword Field** or **Promo Text** requires an App Store Connect link — both are private App Store fields that can't be read without it.
- Switch stores with the store switcher at the top of the project; you edit one store's draft at a time.

## Open the editor

In the left sidebar under **Listing Edit & Publish**, expand **Asset Editor** and choose **Listing Text**. The page header reads **EDIT: Listing Text**. A row of tabs lets you move between fields.

### Which fields each store has

The available fields differ by store:

| Field (tab) | App Store | Google Play | Character limit |
| --- | --- | --- | --- |
| App Title | Yes | Yes | 30 |
| Subtitle | Yes (Subtitle) | Yes (Short Description) | 30 App Store / 80 Google Play |
| Description | Yes | Yes | 4000 |
| Keyword Field | Yes | — | 100 |
| What's New | Yes | — | 4000 |
| Promo Text | Yes | — | 170 |

:::note[Subtitle means different things per store]
On the App Store the **Subtitle** tab edits the 30-character subtitle. On Google Play the same tab edits the **Short Description**, which allows 80 characters. Apptonomy enforces whichever limit applies to the store you're editing.
:::

## Edit a field

### 1. Pick the field

Select its tab (for example **Description**). Each field page has two stacked cards: **Live on \{store\}** at the top (read-only, what's currently published) and **Next Version** below it (your editable draft).

### 2. Write your copy

Type into the **Next Version** box. A character usage bar tracks how close you are to the limit. If it helps to start from what's live, click **Copy to editor** on the Live card to pull the published value into your draft.

### 3. Stay inside the rules

- **Over the limit** — if you exceed the field's character cap, the box turns red and shows *"Too long: N characters over the \{limit\}-character limit."* You can't save until you trim it.
- **Invalid characters (App Store)** — the App Store rejects certain symbols. If you paste one, Apptonomy flags it as an invalid character. Click **Allowed Symbols** to see exactly which characters App Store Connect permits.

### 4. Save

Click **Save**. If your project has additional target languages, the button reads **Save & Retranslate** — saving the source text also refreshes the translations for that field. A status badge next to **Next Version** confirms *Saving…* then *Saved*. To throw away unsaved edits, click **Discard Changes**.

When your draft differs from the live listing, a diff appears beneath the editor so you can see exactly what changed.

## Verify it worked

The status badge shows **Saved**, the diff reflects your new wording, and the value persists when you switch tabs and come back. Your change lives in the draft — it does not reach the store until you [publish](/docs/publishing/publish-a-revision).

## Troubleshooting

### The Save button is greyed out

Save stays disabled when there's nothing to commit or the draft breaks a rule. Check for: no changes since the last save; a *Too long* error; or an invalid-character flag (App Store). Fix the flagged issue and Save re-enables.

### The Keyword Field or Promo Text is empty and asks me to link App Store Connect

Both are App-Store-only fields that Apple doesn't expose publicly — Apptonomy can only read and write them through an App Store Connect link. Click **Link App Store Connect** on the Live card and connect the store, then the field becomes editable. These fields don't exist on Google Play at all.

### My subtitle limit looks different than I expected

That's by design. App Store Subtitle is capped at 30 characters; the Google Play Short Description (shown on the same tab) allows 80. The limit shown always matches the store you're currently editing.

## Related

- [Drafts & revisions](/docs/editing/drafts-and-revisions)
- [Adopt AI-suggested content](/docs/editing/ai-suggested-content)
- [Replace icon & screenshots](/docs/editing/asset-editor-visuals)
- [Publish a revision](/docs/publishing/publish-a-revision)
- [Listing localization](/docs/guides/listing-localization)