Docs
Sign in

Publishing apps

Register as a publisher, create a Marketplace listing, declare a version’s permissions and follow it through review.

If you build something that works with UnitX, you can publish it to the Marketplace. The developer portal is where you register as a publisher, create a listing, add versions that declare the permissions they need, and follow each version through review.

Opening the developer portal#

The portal lives at /app/marketplace/developer in UnitX. It has no entry in the sidebar — open the address directly while signed in. Its back link returns you to the Marketplace.

Any signed-in person can use it; no special permission is needed. A publisher account and its listings belong to you rather than to your employer, so they follow you.

Register as a publisher#

  1. Fill in Become a publisher

    Publisher name and Support email are required and are shown to anyone who installs what you publish. Choose an Account type: Individual, Company, Partner or Agency.

  2. Choose Create developer account

    The portal shows your publisher name with a Not yet verified badge.

You can publish before verification. The Verified badge — and the Verified publisher mark on your listings — comes from a review by UnitX, not from anything you set. Each person can have one developer account.

Create a listing#

  1. Name it

    Under New listing, enter a Name. A URL slug is suggested from it.

  2. Check the slug

    The slug is the listing’s permanent Marketplace address; the name can change later but the slug should not. Slugs must be unique across the Marketplace.

  3. Pick a category and describe it

    Choose a Category and write what the app does.

  4. Choose Create draft listing

    It appears under Your listings as a Draft.

Add a version and submit it#

  1. Set the version number

    In the listing’s row, enter a Version (it starts at 1.0.0). Each version number can be used once per listing.

  2. Declare the permissions it needs

    In Permissions it needs, list them separated by commas, for example customers.read, invoices.read. A version must declare at least one: an empty consent screen is not consent.

  3. Choose Add version

    You see that the version was created, and a Submit for review button appears.

  4. Choose Submit for review

    The version enters review, and the three review stages appear under the listing.

The permission list is the ceiling

The permissions a version declares become the consent screen administrators approve, and then the limit of what your app can do in their organization. Anything you did not declare is refused at run time. A later version that needs more permissions has to be approved again by every organization that installed yours.

Review stages#

Every version goes through three stages, in order. The portal shows each one as passed, failed or waiting, with any note the reviewer left for you.

Automated checks
Automatic validation of the version.
Security review
A security review by UnitX.
Marketplace review
A final review of the listing and version.
  • No stage can be skipped, and passing automated checks alone is never enough to publish.
  • A rejected update does not unpublish the version already live. Versions are reviewed and published independently.
  • Reviewer notes addressed to you are shown; reviewers’ internal findings are not.

Listing statuses#

Draft
Created, not yet submitted.
Submitted
Waiting for review to start.
Under review
Moving through the review stages.
Approved
Passed review, not yet published.
Published
Visible and installable in the Marketplace.
Rejected
Did not pass review. Read the reviewer’s note.
Suspended
Temporarily removed from the Marketplace by UnitX.
Deprecated
No longer offered to new installs.

Limitations#

  • The portal shows review progress for the version you have just added in that visit. It does not currently list a listing’s earlier versions.
  • Pricing is not set from the portal. A paid listing needs a price above zero, and a free listing cannot carry a price.
  • You cannot rate your own listing, and neither can anyone in your organization.
How much does the platform keep from a sale?

The revenue split is a commercial arrangement configured per deployment rather than a fixed part of the product, so it is not published here.

“That slug is already taken”

Another listing uses that address. Choose a different slug.

How does my app call UnitX?

Through the UnitX REST API. See API overview and OAuth applications.

Still stuck? Search the docs with ⌘K, open Help inside UnitX, or contact support.