> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Publish to the App Store

> Create a public listing and submit your app for review to make it available to all merchants.

<Warning>
  Public App Store listings are currently unavailable while the payment infrastructure is being finalized. If you need to distribute your app today, see <a href="/cloud/get-started/submitting-your-app/share-private-app">Share a Private App</a>.
</Warning>

Publishing makes your app available to every merchant in the [App Store](https://apps.jtl-cloud.com/). You define a public listing, submit it, and JTL reviews it before it goes live.

## What Publishing Gives You

A public listing puts your app in front of every merchant on the platform, rather than only the ones you share it with directly. Merchants find it by browsing or searching the store and install it directly from the App Store.

Public listings also carry pricing. You define subscription tiers, free or paid, monthly or annual, with an optional trial, and merchants subscribe through the store.

## What You'll Need

Publishing requires:

* **Seller registration with JTL.** [Register as a seller](https://www.jtl-software.de/extension-store/Seller-werden) to distribute apps to merchants.
* **Payment setup.** Public App Store listings rely on merchant billing, which is still being rolled out.
* **A deployed app.** Your app runs at a public URL with HTTPS, with production URLs set in your app and listing manifest.

## What a Listing Covers

Your listing is what merchants see in the store. It describes your app in every locale you support:

* Its name, description, and three to five benefits.
* A category and subcategories, so merchants find it where they expect.
* Icons for light and dark mode, screenshots, and an optional product video.
* The JTL products it works with, and the minimum version of each.
* Subscription tiers, up to four, each free or paid.
* Your support URL, and the privacy, terms, and GDPR URLs required for compliance.

You define all of this in a [Listing Manifest](/cloud/guides/cloud-apps/listing-manifest).

## How Review Works

Once public submissions are available, JTL will review every listing before it reaches merchants. A listing moves through these states:

| Status      | Meaning                                                                          |
| ----------- | -------------------------------------------------------------------------------- |
| `DRAFT`     | You're still working on the listing. Editable.                                   |
| `SUBMITTED` | You've submitted the listing. Review hasn't started.                             |
| `IN_REVIEW` | JTL is reviewing your listing.                                                   |
| `APPROVED`  | Your listing is approved and live in the App Store.                              |
| `REJECTED`  | Review found issues to address. Editable again so you can fix them and resubmit. |

While your listing is `SUBMITTED`, `IN_REVIEW`, or `APPROVED`, it's locked for editing. If it's rejected, you edit it to address the feedback and submit again.

## In the Meantime

You can distribute your app today with a private listing. Merchants install it using activation codes you generate and share, and the app behaves the same way once installed.

<CardGroup cols={2}>
  <Card title="Share a Private App" icon="key" href="/cloud/get-started/submitting-your-app/share-private-app">
    Share your app with selected merchants using activation codes.
  </Card>

  <Card title="Listing Manifest" icon="store" href="/cloud/guides/cloud-apps/listing-manifest">
    The field reference for listing manifests.
  </Card>
</CardGroup>
