# How to Publish an App

Once your account is set up and connected, you're ready to publish. The process starts in App Store Connect, where you'll upload your build and submit it for review.

Onside offers two distinct paths for publishing your app, each with its own benefits. Choose the one that best suits your distribution strategy.

***

### Choosing Your Publishing Path

{% tabs %}
{% tab title="App Store Review (Onside + AppStore)" %}
This is the standard path for developers who want their app to be available on **both the main App Store and Onside.**

* **Best For:** Developers looking to maximize their reach by being on both platforms and who want to easily sync their existing App Store presence with Onside.
* **Process:** Your app goes through the standard App Store Review process. Once approved by Apple, it will appear on both stores.
* **Syncing:** This path enables seamless, automatic syncing of your app builds and metadata from the App Store to Onside. You can set it up once and get additional visibility and installs from Onside with minimal extra effort.

{% hint style="info" %}
This is the recommended path for most developers who already have or plan to have a presence on the main App Store.
{% endhint %}
{% endtab %}

{% tab title="Notarization (Publish on Onside Only)" %}
This is a streamlined path for developers who want their app to be available **exclusively on Onside.**

* **Best For:** Developers looking for a faster path to market or those with apps in categories that benefit from more flexible guidelines (provided they are fully compliant with EU law).
* **Process:** Your app goes through Apple's Notarization process. This is a lighter, automated review focused primarily on security, checking for malware and basic functionality, rather than the full set of App Store content guidelines.
* **Speed:** Notarization is typically much faster than a full App Store Review. While the first notarization can sometimes take longer, subsequent ones are often very quick.

{% hint style="info" %}
Even with Notarization, your app must meet certain basic functionality requirements outlined in Apple's [Notarization Review Guidelines](https://developer.apple.com/app-store/review/guidelines/). For example, if your app includes "Sign in with Apple," it must function correctly. If your app requires a login, you must provide test credentials in the review notes.
{% endhint %}
{% endtab %}
{% endtabs %}

***

### Publishing Steps in App Store Connect

The first part of the process happens in your App Store Connect account.

{% stepper %}
{% step %}

#### Upload Your Build

Prepare and upload your app build to **App Store Connect** just as you normally would. Onside will sync this build automatically.
{% endstep %}

{% step %}

#### Prepare for Submission

* In App Store Connect, select your app and navigate to the version you want to submit.
* Scroll down to the **App Review Information** section.
* If your app requires a login to access its core features, you **must** provide a valid username and password in the "Sign-in information" section. This is required for both App Store Review and Notarization.

<div align="left"><figure><img src="https://3698875069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV24VBLkTP47H3Kf48DFs%2Fuploads%2FS9OdBnu8dXWXaGax3HIf%2FStep%3D1.png?alt=media&#x26;token=f859e305-be4a-42a1-a250-80ca75d2d4c3" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Select Your Review Type

* In the "App Review Information" section, find **Review Type** and click **Edit**.
* A pop-up will appear. Choose either **App Store** or **Notarization**, depending on the path you selected above.
* Click **Save**.

<div align="left"><figure><img src="https://3698875069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV24VBLkTP47H3Kf48DFs%2Fuploads%2FDTELoMtFh7Z74AOJJrj0%2FStep%3D2.png?alt=media&#x26;token=c3d30cc3-f352-4209-aeb0-b637ecf47ad9" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://3698875069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV24VBLkTP47H3Kf48DFs%2Fuploads%2F4CCL1JT82H2xeTLemdCx%2FStep%3D3.png?alt=media&#x26;token=e09f1665-80c4-4989-8f1f-d6b33a90c3bf" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Submit for Review

* At the top right of the page, click **Add for Review**.
* Follow the final prompts to **Submit to App Review**.

<div align="left"><figure><img src="https://3698875069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV24VBLkTP47H3Kf48DFs%2Fuploads%2FAgs74c7swnZJRvD1DErh%2FStep%3D4.png?alt=media&#x26;token=fcd0df1c-9579-482e-a12f-2d9e67942938" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

### Final Steps in the Onside Console

After your app successfully passes either App Store Review or Notarization, it will appear in your Onside Developer Console, with a status "Missing Info".

1. Go to the **Apps** section in your Onside Console.
2. Click on your app.
3. Complete the remaining setup steps, such as setting the app's **Price** and **Availability** (the countries where it will be available).
4. Once all information is complete, click **Publish**.

Your app will then be live on the Onside Store!

***

### Troubleshooting & FAQs

<details>

<summary><strong>I don't see the "Notarization" option in the Review Type pop-up.</strong></summary>

This usually means the app has not been made eligible for alternative marketplace distribution in your App Store Connect settings.

1. Go to **App Store Connect > Users and Access > Alternative Distribution**.
2. Click on the **Onside** marketplace entry.
3. Ensure the app you are trying to publish is **checked** in the list of eligible apps.
4. Click **Save**.

</details>

<details>

<summary><strong>My app was approved by Apple, but I don't see it in my Onside Console.</strong></summary>

This can happen for a couple of reasons:

* **App Not Selected for Onside:** The most common reason is that the app hasn't been enabled for Onside distribution. Follow the steps in the expandable section above to ensure your app is selected in the **Alternative Distribution** settings in App Store Connect.

{% hint style="danger" %}
Please note: If you add a **new app** to your App Store Connect account, it is **not** automatically enabled for Onside. You must manually go into the **Alternative Distribution** settings each time to add new apps to the list.
{% endhint %}

* **Marketplace Token Issue:** In rare cases, there might have been an issue with your Marketplace Token connection. Please go to **App Store Connect > Users and Access > Alternative Distribution** and verify that the Onside marketplace is listed and active. If not, you may need to re-complete the connection steps.

</details>


---

# 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.onside.io/console/publishing-your-app/how-to-publish-an-app.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.