> For the complete documentation index, see [llms.txt](https://docs.appstoremanager.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appstoremanager.net/documents/readme/how-to-work-with-the-app-store-manager.md).

# Detailed Walkthrough

This walkthrough covers the complete workflow from setting up your first app to uploading metadata, screenshots, and Custom Product Pages to the stores.

```mermaid
flowchart LR
    subgraph Setup
        A[Create App]
        B[Create Store Listing]
    end
    subgraph Content
        C[Add Metadata]
        D[Add Screenshots]
    end
    subgraph Optional
        E[Translate]
        F[Validate]
    end
    subgraph Publish
        G[Upload to Stores]
    end

    A --> B --> C --> D --> E --> F --> G
    D --> G

    style A fill:#FF9800,color:#fff
    style B fill:#FF9800,color:#fff
    style C fill:#9C27B0,color:#fff
    style D fill:#9C27B0,color:#fff
    style E fill:#2196F3,color:#fff
    style F fill:#2196F3,color:#fff
    style G fill:#4CAF50,color:#fff
```

{% hint style="warning" %}
**Prerequisites:**

* You require a developer account for App Store Connect and/or Google Play Console.
* The app already exists within the respective store (draft or published).
  {% endhint %}

***

## 1. Create an App

After logging in to the [App Store Manager](https://appstoremanager.net/), click **My apps** on the front page.

<figure><img src="/files/F8I1M5dCcad5Yf9ovhwK" alt=""><figcaption><p>App Store Manager front page</p></figcaption></figure>

### Add an app manually

Click **New App** and provide:

| Field                        | Description                                                         |
| ---------------------------- | ------------------------------------------------------------------- |
| **Platform**                 | Android or iOS                                                      |
| **Name**                     | A display name (use your real app name for clarity)                 |
| **Package name / Bundle ID** | The technical identifier from your app code and store configuration |

### Add an existing published app

Already published? Use the search function instead:

1. Enter the app title (or part of it)
2. Select the platform (Android or iOS)
3. Choose the store language
4. Click **Search**

<figure><img src="/files/loM7zgql2Hfq88tDGLVs" alt=""><figcaption><p>Search and add existing apps</p></figcaption></figure>

Select your app from the results and click **Finish**.

{% hint style="info" %}
If your app doesn't appear, check the spelling, ensure it's published, and verify the platform selection. Unpublished apps must be added manually.
{% endhint %}

***

## 2. Create a Store Listing

A **Store Listing** (formerly called "package") is a container for your metadata and assets. You can create multiple store listings for different occasions — regular operation, seasonal campaigns, A/B tests, etc.

Open your app and click **New Store Listing**.

<figure><img src="/files/jEQ2d9eUZIbxL7dZibgq" alt=""><figcaption><p>Store listing creation</p></figcaption></figure>

Give it a descriptive name and click **Save**.

A store listing contains:

| Asset Type           | Contents                                                               |
| -------------------- | ---------------------------------------------------------------------- |
| **App descriptions** | Title, short description, long description, keywords, promotional text |
| **Screenshots**      | All device sizes, all languages                                        |
| **App previews**     | Video previews (iOS only)                                              |
| **Icons & graphics** | App icon, feature graphic (Android)                                    |

***

## 3. Add Metadata

Navigate to **App descriptions** in your store listing. Here you can manage text content for all languages.

<figure><img src="/files/r4IFxGGvT7bWgviGIqOP" alt=""><figcaption><p>Metadata editing view</p></figcaption></figure>

### Input methods

**Type directly** — Enter content manually for each language and field.

**Import from store** — Pull existing metadata from your live App Store Connect or Google Play listing.

<figure><img src="/files/9Fd5wKztnhjFJakzdw3K" alt=""><figcaption><p>Import from store</p></figcaption></figure>

**Import from file** — Use Excel or JSON templates to bulk-import content.

<figure><img src="/files/iVerFzSWn5HqCkowU6yp" alt=""><figcaption><p>Import from file</p></figcaption></figure>

{% hint style="info" %}
Store access requires API credentials. See [App Store Connect access](/documents/access/app-store-connect-access.md) or [Google Play Console access](/documents/access/google-play-console-access.md).
{% endhint %}

After import, preview and select which languages to add:

{% hint style="warning" %}
Google Play requires title, short description, and description when creating a new language. These fields are **mandatory**.
{% endhint %}

***

## 4. Add Screenshots (Drag & Drop)

Navigate to **Screenshots** in your store listing. The Screenshot Manager supports drag & drop with **Smart Recognition** — it automatically detects language, device size, and slot position from your folder structure and filenames.

<figure><img src="/files/lmyZFolRnRRAExecbE1a" alt=""><figcaption><p>Screenshot Manager</p></figcaption></figure>

### How to upload

1. **Drag files or folders** directly into the Screenshot Manager
2. The Smart Recognition Engine detects:
   * **Language** — from folder names like `en-US`, `german`, `deutsch`
   * **Slot position** — from filenames like `1.png`, `en-US_3_1290x2796.png`
   * **Device size** — from the actual image dimensions
3. **Review** the auto-assigned positions
4. **Manually assign** any files in "Uncategorized"

<figure><img src="/files/JWxKlnChefOz87SCB78s" alt=""><figcaption><p>Auto-detected locales and resolutions</p></figcaption></figure>

{% hint style="success" %}
Organize your screenshots in folders by language (e.g., `screenshots/en-US/`, `screenshots/de-DE/`) for automatic recognition.
{% endhint %}

### Alternative upload methods

| Method                 | Best for                                     |
| ---------------------- | -------------------------------------------- |
| **Screenshot Manager** | Day-to-day management with real-time control |
| **ZIP upload**         | Automated bulk processing                    |
| **Google Drive**       | External storage and team sharing            |

See [Screenshot and asset upload](/documents/edit-translate-and-upload/screenshot-and-asset-upload.md) for templates and technical specifications.

***

## 5. Add App Previews (Videos)

Navigate to **App Previews** in your store listing. Video uploads work the same as screenshots — drag & drop with Smart Recognition.

<figure><img src="/files/7OY0Uy39c3FeWHCYDDSD" alt=""><figcaption><p>App preview upload</p></figcaption></figure>

{% hint style="info" %}
App previews are only supported for **App Store Connect**. Google Play uses YouTube URLs set directly in the console.
{% endhint %}

**Requirements:**

* Duration: 15–30 seconds
* Max file size: 500 MB
* Max 3 previews per device size per locale
* Formats: `.mov`, `.m4v`, `.mp4`

See [App preview upload](/documents/edit-translate-and-upload/app-preview-video-upload.md) for full specifications.

***

## 6. Translate (Optional)

Use automatic translation to expand into new markets quickly.

1. Navigate to **App descriptions**
2. Click **Translate**
3. Select the **source language**
4. Select **target languages**
5. Click **Translate**

<figure><img src="/files/Qy79YUQoiy5LZYK1gaQC" alt=""><figcaption><p>Automatic translation</p></figcaption></figure>

Preview and select which translations to adopt:

<figure><img src="/files/YDv6N3peJTvZQZewJQFR" alt=""><figcaption><p>Translation in progress</p></figcaption></figure>

{% hint style="warning" %}
Translations consume characters from your subscription plan. Review translations carefully — word lengths vary between languages.
{% endhint %}

***

## 7. Validate

Before uploading, check for errors. The App Store Manager shows validation status for each language:

* **Bold fields** — filled
* **! icon** — validation error (usually exceeds character limit)

Use the filter to quickly find languages with errors.

Common issues:

* Text exceeds maximum length
* Required fields empty
* Invalid characters

***

## 8. Upload to Stores

Navigate to **Upload to…** and select the languages to transfer.

<figure><img src="/files/Nto1nB1SjsD9iQPh7IdB" alt=""><figcaption><p>Select languages for upload</p></figcaption></figure>

{% hint style="danger" %}
Uploading **overwrites** existing content in the store. Empty fields do not overwrite — only filled fields are transferred. Create a backup before uploading.
{% endhint %}

### Upload options

| Platform    | Options                                                                       |
| ----------- | ----------------------------------------------------------------------------- |
| **Android** | Select release track: production, beta, alpha, or internal                    |
| **iOS**     | Changes are staged — you must manually submit for review in App Store Connect |

### Start the upload

1. Select languages
2. Add credentials (if not saved)
3. Click **Upload**
4. Monitor progress in the activity log

<figure><img src="/files/8LjNuOb9LnuMabgw41Tv" alt=""><figcaption><p>Activity log</p></figcaption></figure>

{% hint style="info" %}
Full uploads with all languages and resolutions can take up to 1 hour. Business customers receive prioritized processing.
{% endhint %}

***

## 9. Custom Product Pages (iOS)

Custom Product Pages let you create alternate App Store listings for different audiences or campaigns. Available for Premium Plan subscribers.

<figure><img src="/files/ZNX04u4Or95iodShBwy4" alt=""><figcaption><p>Custom Product Pages overview</p></figcaption></figure>

### Create a CPP

1. Navigate to **Custom Product Pages**
2. Click **New CPP**
3. Enter a name (used as identifier in App Store Connect — cannot be changed later)

<figure><img src="/files/LONX3DdcAx0OR3rHJswE" alt=""><figcaption><p>Name your Custom Product Page</p></figcaption></figure>

### Add content

**Promotional text** — Import/export via JSON or Excel templates.

<figure><img src="/files/bVC8BXOIeKr9INsBOHPw" alt=""><figcaption><p>CPP promotional text</p></figcaption></figure>

**Screenshots** — Same drag & drop workflow as standard store listings.

<figure><img src="/files/MLgTFQNJRzqSiUCKNcBL" alt=""><figcaption><p>CPP screenshot upload</p></figcaption></figure>

### Upload and submit for review

When ready, upload the CPP to App Store Connect. You can submit directly for Apple review from within App Store Manager.

<figure><img src="/files/SiOu03Srhu1Hfipzc5qM" alt=""><figcaption><p>Upload and submit CPP for review</p></figcaption></figure>

{% hint style="success" %}
App Store Connect supports up to 35 Custom Product Pages simultaneously.
{% endhint %}

***

## Quick Reference

| Task                 | Location                             |
| -------------------- | ------------------------------------ |
| Create app           | My apps → New App                    |
| Create store listing | App → New Store Listing              |
| Edit metadata        | Store Listing → App descriptions     |
| Upload screenshots   | Store Listing → Screenshots          |
| Upload videos        | Store Listing → App Previews         |
| Translate            | App descriptions → Translate         |
| Upload to store      | Store Listing → Upload to…           |
| Manage CPP           | Store Listing → Custom Product Pages |

***

## Next Steps

* [Supported languages](/documents/edit-translate-and-upload/supported-languages.md)
* [Screenshot specifications](/documents/edit-translate-and-upload/screenshot-and-asset-upload.md)
* [App preview specifications](/documents/edit-translate-and-upload/app-preview-video-upload.md)
* [Custom Product Pages](/documents/edit-translate-and-upload/custom-product-pages.md)

Need help? [Contact us](https://www.iwantanelephant.com/contact/)