Skip to navigation
Build an extension app

Extension app status and distribution

View as Markdown

The Developer Console displays two types of status for each extension app:

  • Status: Indicates the current stage of an extension app in the development, review, and publishing process.
  • Distribution: Indicates whether the published version of an extension app is available to all App Center users or only to users in accounts that you specify.

By default, published extension apps are available only to US customers on the production App Center. You can specify availability in additional regions. See Globalization for details.

My Apps page

Display the status and distribution for extension apps

You can see status and distribution information in these Developer Console locations:

  • My Extension Apps page: Lists all extension apps in your account, including the status for each extension app’s latest version and the distribution. The My Apps page is displayed when you log in to the Developer Console.
  • Header in the extension app detail pages: Selecting an extension app on the My Extension Apps page displays a menu of detail pages where you can perform various tasks. Each detail page header includes the latest version number, the status of that version, and the distribution type.
  • App Versions page: An extension app detail page that lists all versions of an extension app, including their statuses and changelog details.

Status

Each version of an extension app has a status. An extension app can have multiple versions in different statuses.

For an extension app that has multiple versions, only one version can be in any of these statuses at a time: Draft, In Review, Approved, or Rejected. You cannot create a new draft version while any other version is in Draft, In Review, Approved, or Rejected status.

Extension app statuses are described below.

StatusDescriptionProhibited actionsNotes
DraftThe extension app version is being registered and tested.PublishingExtension app versions in this status can be used for testing in envelopes and workflows in your developer account. They cannot be used in production, and members of other accounts cannot view or install them.
After you have finished development and testing, you can start the process to publish an extension app to the Docusign App Center.
You can delete an extension app version only if it’s in Draft status.
In ReviewThe extension app version has been submitted for Docusign review to obtain approval to publish it to the App Center.Updating

Publishing
Deleting		An extension app version that’s been submitted for review remains in this status until Docusign approves or rejects it.
To update or delete a version that’s in this status, you must first cancel the publishing process so that the version reverts to Draft status. After updating it, you must resubmit it for review if you want to publish it to the App Center.
ApprovedDocusign has completed review of the extension app version and approved it for distribution in the App Center.Updating
Deleting		An extension app version that’s been approved remains in this status until you publish it or cancel publication.
To update or delete a version that’s in this status, you must first cancel the publishing process so that the version reverts to Draft status. After updating it, you must resubmit it for review if you want to publish it to the App Center.
RejectedThe extension app version failed Docusign review.Updating
Publishing
Deleting		To update or delete a version that’s in this status, you must first cancel the publishing process so that the version reverts to Draft status. After updating it, you must resubmit it for review if you want to publish it to the App Center.
LiveThe extension app version has been published to the App Center.Deleting

Publishing		Live extension app versions can be viewed and installed on the production App Center. Availability may be restricted by the distribution type or region. See Distribution for details.
If you update the registration details for a Live extension app, Docusign creates a new version in Draft status. You can submit the new version for review and publish it after it has passed. The new version becomes Live on publication, and the previous Live version’s status changes to Discontinued. See Extension app versioning for details.
For an extension app that has multiple versions, only one version can be Live.
You cannot delete an extension app version that’s in Live status. If you want to remove a live extension app from the App Center without replacing it with a new version, please visit the Docusign Developer Community for information and assistance.
DiscontinuedThis previously Live version of an extension app has been replaced with a new version.Updating
Publishing
Deleting		When a newer version of an extension app passes Docusign review and you publish it, the previous Live version’s status changes to Discontinued.
When a version’s status becomes Discontinued:
  • It is no longer listed on the Docusign App Center and cannot be installed.
  • Any accounts that had the Discontinued version installed are automatically upgraded to the new Live version.
    Discontinued versions appear only on the App Versions page.

Distribution

An extension app has only one distribution type, regardless of the number of versions. You define the distribution type when you register an extension app.

The distribution types are:

  • Public: After the extension app has been published and is in Live status, it can be used in production by any App Center user whose account is based in an allowed region for the app. See Globalization for more information.
  • Private: The Live extension app version is available in production only to users in accounts that you specify. See Choosing private distribution instead of public for details about how private and public extension apps differ.

This table summarizes how an extension app’s distribution type and status determine the app’s availability to users on the demo and production App Centers.

DistributionStatusAvailable on demo App Center toAvailable on production App Center to
PublicDraft or other pre-publication statusUsers under your developer accountNot available
PublicLiveUsers under all accountsAny user whose Docusign account is based in one of the allowed regions for the extension app. See Globalization for details.
PrivateDraft or other pre-publication statusUsers under your developer accountNot available
PrivateLiveUsers under your developer accountAny user under the accounts that you share the extension app with during publication. In the current release, private extension apps can be shared only with accounts based in the US.
Note: Before users can view and install your extension app, their account administrator must approve it. See Choosing private distribution instead of public for details.

Next steps