# 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/)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appstoremanager.net/documents/readme/how-to-work-with-the-app-store-manager.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.