Skip to navigation

Globalization

View as Markdown

You have the option of making your extension app available for production use in specific regions.

If you limit your extension app’s availability by region, App Center users can install your extension app only if their account is based in a Docusign data center that corresponds to one of the allowed regions.

This table lists the supported regions and the Docusign data centers that each region includes.

RegionData centers
AustraliaAU
CanadaCA
European UnionEU
JapanJP1
United StatesNA1, NA2, NA3, and NA4

For example, if you limit your extension app to the United States region, Docusign users can install your extension app for production use if their account is based in the NA1, NA2, N3, or NA4 data center.

Note: Additional globalization features, such as the ability to localize extension app metadata for specific languages, will be available in future releases.

Behaviors and limitations

Regional availability for extension apps is subject to these behaviors and limitations:

  • Region restrictions apply only in the production App Center. In the demo App Center, published extension apps are available to all users, regardless of region.
  • In the production App Center, users who have not logged in will see listings only for extension apps that are available to the US region. After logging in, users will see listings for apps that are available to their region.

Implement regional availability for an extension app

You define supported regions when you register an extension app.

If you will register the extension app using a form, see Update distribution details for instructions on defining the regions.

If you will register the extension app using an app manifest file, set the value of publicationRegions to an array of regions in which your app should be available. See App manifest reference for the list of valid values and an example.

If you omit publicationRegions when creating a new app manifest, a default value of US will be used. If you omit publicationRegions when updating an app manifest for a published extension app, the value from the published version will be used. If publicationRegions is set to an empty array, the Developer Console will return a validation error.

When updating extension app registration details for a published extension app, you can add regions, but you cannot remove them. Removing regions from a published extension app is not recommended and not supported in the Developer Console. If absolutely necessary, please visit the Docusign Developer Community for information and assistance. Requests will be handled on a case-by-case basis.

You may need to configure your firewall to allow requests from IP addresses associated with the selected regions. See Firewall configuration for details.

Next steps