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

# List your app

> Fill in your app's details, submit it to CRMs' marketplaces, and track each review.

Each CRM runs its own marketplace. You submit your app to it, the CRM reviews
it, and once it's approved, the CRM's agents can turn it on for themselves, or
their admins for the whole org.

## Fill in your app's details

On **Embedded apps → Apps**, choose your app, or **Register an app**:

![The Register an app form in the Rollout dashboard, with Name, Tagline, Description and App URL filled in for an example app](https://mintcdn.com/rollout/l0jLuVTIfNu5jYvw/images/embedded-apps/dashboard-register-app.jpg?fit=max\&auto=format\&n=l0jLuVTIfNu5jYvw\&q=85\&s=d31b76ee662773a8388719a33dcdfea3)

| Field | Required | Rules | Shown to |
| - | - | - | - |
| Name | Yes | Up to 100 characters | Agents, on the app's card and above its frame |
| Tagline | No | Up to 200 characters | Agents, on the card |
| Description | No | Up to 5,000 characters; line breaks are kept | Agents, on the card |
| App URL | Yes | `https`, or `http` on `localhost` or `127.0.0.1` for development. Its host name has letters, digits, dots and hyphens only | Loaded in the frame |
| Icon | No | A PNG, JPEG or WebP image, 64 to 1024 px on each side and up to 512 KB. Square is best: it's shown at 40×40 px, cropped to fit. SVG isn't accepted | Agents, on the card |
| Support URL | No | `http` or `https` | Agents, on the card |
| Privacy policy URL | No | `http` or `https` | Agents, on the card |

Rollout keeps any query parameters in your app URL, and adds `context` and
`signature` to them. It hosts your icon itself, so CRMs load nothing from your
servers.

Your app has one URL for every marketplace it's listed in.

> [!WARNING]
>
> **Changing the app URL sends every approved or suspended listing back to
> review.** Your app is hidden from those marketplaces' agents until each CRM
> approves it again. The dashboard warns you before you save. The name, tagline,
> description, icon and other URLs change without a review.

## Submit to a marketplace

On **Embedded apps → Marketplaces**, you see every public marketplace, and any
marketplace you're already listed in, each with its CRM and description.
Choose **List an app**, pick your app, write a message to the CRM of up to
2,000 characters, and choose **Submit for review**.

![The Marketplaces tab in the Rollout dashboard: a marketplace card with its CRM, the app already listed there as Approved, and a List an app button](https://mintcdn.com/rollout/l0jLuVTIfNu5jYvw/images/embedded-apps/dashboard-marketplaces.jpg?fit=max\&auto=format\&n=l0jLuVTIfNu5jYvw\&q=85\&s=68692fc735aea47ee557eaaefd3ee455)

The CRM reviews your app in a [preview](https://rollout.com/docs/embedded-apps/verify-the-context.md#previews):
a launch with a made-up agent and contact, and `x.preview: true`. Make sure your
app shows something worth judging on a preview, such as sample data, rather
than a sign-in screen.

## Track your listings

**Embedded apps → Listings** shows each listing's status, the CRM's note, and,
once it's approved, its installs: how many agents and orgs have it on.

![The Listings tab in the Rollout dashboard: one approved listing with its marketplace, submitted date, installs and a Withdraw button](https://mintcdn.com/rollout/l0jLuVTIfNu5jYvw/images/embedded-apps/dashboard-listings.jpg?fit=max\&auto=format\&n=l0jLuVTIfNu5jYvw\&q=85\&s=7a0d95bae14d242df7b7158665d42cba)

| Status | Meaning | You can |
| - | - | - |
| Pending review | Waiting for the CRM's review. | Withdraw it |
| Approved | Available to the marketplace's agents, who still turn it on themselves. | Withdraw it |
| Rejected | The CRM declined it. Its note says why. | List it again |
| Suspended | The CRM has hidden it for now. Its note says why. | Wait for the CRM to reinstate it, or change the app URL to send it back to review |
| Withdrawn | You took it out. | List it again |

```mermaid theme={null}
stateDiagram-v2
  [*] --> pending: You submit it
  pending --> approved: CRM approves
  pending --> rejected: CRM rejects, with a note
  pending --> withdrawn: You withdraw
  approved --> suspended: CRM suspends, with a note
  suspended --> approved: CRM reinstates
  approved --> withdrawn: You withdraw
  approved --> pending: You change the app URL
  suspended --> pending: You change the app URL
  rejected --> pending: You list it again
  withdrawn --> pending: You list it again
```

Listing again sends your app back to review with your new message, and clears
the previous note.

Withdrawing, suspending or changing the app URL hides your app without turning
it off for anyone. Once it's approved again, every agent and org that had it on
sees it again. No emails are sent when a listing changes status, so check the
dashboard.

Your apps are also hidden from every marketplace while your Rollout account is
deactivated.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.