# 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-354543f2877dfd082aaccd6c8f0f9903dd12a20f%2Fapp-store-manager-dashboard-frontpage.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-a494357517230cd6b91f54b1a45dbd58f9ff683d%2Fapp-store-manager-search-add-existing-app.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-c5df36112e46e59e854a17b4890f6597e7e08231%2Fapp-store-manager-package-creation-overview.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-fbf22a5a491b6428a21f96a0b1347a4ca23b45dc%2Fapp-store-manager-metadata-editing-view.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-21d136417d07264eaccaa1f1ea158efd8b5013c6%2Fapp-store-manager-import-existing-metadata.png?alt=media" alt=""><figcaption><p>Import from store</p></figcaption></figure>

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

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-13d68a42ea333532bd061ddb1e9f22024a465c6f%2Fapp-store-manager-metadata-file-import.png?alt=media" alt=""><figcaption><p>Import from file</p></figcaption></figure>

{% hint style="info" %}
Store access requires API credentials. See [App Store Connect access](https://docs.appstoremanager.net/documents/access/app-store-connect-access) or [Google Play Console access](https://docs.appstoremanager.net/documents/access/google-play-console-access).
{% 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2FoWtG3y4UeutVVJgYoyC7%2FAsm-screenshot-upload-example.png?alt=media&#x26;token=7b528cdf-b2cd-44d8-a999-c360ce6d45ce" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2FmE0noJbzfXsgQ13nLn7O%2FAsm-recognition.png?alt=media&#x26;token=ef81288f-57a8-40a0-aa98-541b1b2677be" 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](https://docs.appstoremanager.net/documents/edit-translate-and-upload/screenshot-and-asset-upload) 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fx161l9QuwBONd9feIyUN%2FASM-video-upload.png?alt=media&#x26;token=75339ca0-e3f6-4733-a557-e002e513642a" 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](https://docs.appstoremanager.net/documents/edit-translate-and-upload/app-preview-video-upload) 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-2564b7c61e2472bcd8479a50b2aeafda3089878b%2Fapp-store-manager-automatic-translation-feature.png?alt=media" alt=""><figcaption><p>Automatic translation</p></figcaption></figure>

Preview and select which translations to adopt:

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-23384d674e22ddcc9f04abe9c3fd1d14708d078e%2Fapp-store-manager-translation-in-progress.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-342b72d569b63c180a8d142bc26190728bc2b056%2Fapp-store-manager-select-languages-upload.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-116008ac60f45befc7f0b72365112e0eb2db2979%2Fapp-store-manager-activity-log-view-detail.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-f69cd28d20e3b064fd3d9c84fd42440af144ce33%2Fios-custom-product-pages-overview.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-a40acfc44c4c4fc78fc47368b39a0a228f834327%2Fios-custom-product-pages-naming.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-a7e088089b23c36b3d14af8c4dbe956eececd6bf%2Fios-custom-product-pages-promotional-text.png?alt=media" alt=""><figcaption><p>CPP promotional text</p></figcaption></figure>

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

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-c64d2a63ca5eba37487fd1bbea2b785564f27ab5%2Fios-custom-product-pages-screenshot-upload.png?alt=media" 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="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-66af1e48aabf0f6a85f10c9f2bef11ef551e1c3f%2Fios-custom-product-pages-upload-dialog.png?alt=media" 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](https://docs.appstoremanager.net/documents/edit-translate-and-upload/supported-languages)
* [Screenshot specifications](https://docs.appstoremanager.net/documents/edit-translate-and-upload/screenshot-and-asset-upload)
* [App preview specifications](https://docs.appstoremanager.net/documents/edit-translate-and-upload/app-preview-video-upload)
* [Custom Product Pages](https://docs.appstoremanager.net/documents/edit-translate-and-upload/custom-product-pages)

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