Manage licenses

As an administrator or member of a custom role with the privilege to manage licenses, you use the ArcGIS Enterprise portal to specify which members have access to licensed apps that aren't already included in their assigned user type. For example, you can assign add-on licenses for licensed apps such as ArcGIS Pro, ArcGIS Navigator, ArcGIS AppStudio Developer Edition, ArcGIS Drone2Map, ArcGIS Business Analyst web app, ArcGIS Community Analyst, ArcGIS GeoPlanner, and ArcGIS Insights. You can also assign add-on licenses for apps that were purchased separately, for capabilities and apps included in organization extensions, or for user type extensions.

Note:

Organization extensions in ArcGIS Enterprise have unique configurations. Refer to the extension documentation for details.

You can view license and user type details and configure add-on licenses for a single product at a time and multiple products at once.

Import licenses

Licenses are managed through a single .json file downloadable from My Esri. If there are any changes to your organization's licensing, you must obtain a new .json file containing all licenses, which will overwrite the old license file when imported.

You can import the new license file through the portal or the command line.

Import licenses in the portal

You can import a new license file in the portal.

1. Verify that you are signed in as an administrator of your organization or a member of a custom role with the privilege to manage licenses.
2. At the top of the site, click Organization and click the Licenses tab.
3. Click Import Licenses.
4. Choose the .json license file and click Open.
5. Click Import.

The new licensing is reflected on your Licenses page, and you can assign licenses to members here.

Note:

When importing a new license file, any user types or app licenses in your portal are overwritten by the new license file. For example, if you had apps in your portal that are no longer included in your new license file, these apps are removed when the new license file is imported.

Import licenses using the command line

You can use the importlicense command line utility to import a new license file.

To use the importlicense command line utility, run the importlicense.sh script with -h or -help as follows:

<Portal for ArcGIS Installation Directory>/tools/importlicense/importlicense.sh -help

Example usage with the utility: importlicense.sh [-u <arg>] [-p <arg>] [-lf <arg>]

Option	Description
-u; --username	Username for an account with administrative privileges to the portal
-p; --password	Password of the account specified for the username parameter
-lf; --licenseFile	The path to the portal license file
-h; --help	Displays the tool help and exits

View license and user type details

The licensing page includes details about your organization's add-on licenses and user types, including compatibility tips that help you make decisions when managing licenses.

Tip:

For a preview of the number of licenses and user types available and assigned to members, refer to the Add-on licenses and Members cards on your organization's Overview tab.

1. Verify that you are signed in as an administrator of your organization or a member of a custom role with the privilege to manage licenses.
2. At the top of the site, click Organization and click the Licenses tab.
3. Click the User types tab to see the assigned and available user types in your organization, as well as the included licenses, compatible add-on licenses, and compatible roles for each user type.
4. Click the Add-on licenses tab to see the add-on licenses you have available and assigned in your organization, as well as compatible user types for each.
5. In the ArcGIS Pro section, click License activity to see which members are currently using ArcGIS Pro, the last time they used the app, and whether members have checked out their license (if offline usage is permitted in the organization).

   You can search the members by name to filter the list. A green dot next to the last used date indicates that the member has used ArcGIS Pro in the last 30 minutes. A red dot and a Disconnected label indicate that the member has checked out their ArcGIS Pro license for offline use.

Configure add-on licenses for one product

If you want to configure add-on licenses for a particular product, complete the following workflow. You can use this workflow to assign or unassign the same product for one or more members at a time.

1. Verify that you are signed in as an administrator of your organization or a member of a custom role with the privilege to manage licenses.
2. At the top of the site, click Organization and click the Licenses tab.
3. Locate the add-on license you want to change. If necessary, search the licenses by name. Click Manage.
4. In the window that appears, find the member or members whose license you want to manage. To search the list of organization members, type the member's name in the search box. Use the filters to narrow the list of members.

   For example, you can filter the list to show only members with a particular user type and role, those who have signed in in the last day or a specified date range, or members in a specific group who are assigned an ArcGIS Pro license.

5. If you're assigning a license, click Manage next to each member. To assign the specified add-on license to all assigned members that appear on the page, click Manage all on page.

   If you can't assign the license to a particular member because it's not compatible with their user type, you can update user types on the Members tab.

6. If you're unassigning a license, turn off the license assignment next to each member. To unassign the specified add-on license from all applicable members, turn on the filter to show only members with that license assigned and click Manage all on page.

   You cannot unassign ArcGIS Pro or ArcGIS Drone2Map licenses from users who checked out a license.

7. Close the window to return to the licenses page.

End an active ArcGIS Pro session

Sometimes you may need to end a member's active ArcGIS Pro session to release an add-on license for another member to use.

1. Verify that you are signed in as an administrator of your organization or a member of a custom role with the privilege to manage licenses.
2. At the top of the site, click Organization and click the Licenses tab.
3. In the ArcGIS Pro section, click License activity.
4. In the window that appears, search the members list and click the row for the member to view activity details.
5. Click End session.

   If the member has set an alias name for the workstation from within ArcGIS Pro, you can use that to help confirm the session to close. In ArcGIS Pro, the member starts receiving notifications about the session ending as the app begins to shut down. The member can have up to three simultaneous ArcGIS Pro sessions.

Configure add-on licenses for multiple products

To configure add-on licenses for multiple products at once, complete the following workflow. You can use this workflow to change the add-on licenses for one member or a selected set of members.

1. Verify that you are signed in as an administrator of your organization or a member of a custom role with the privilege to manage licenses.
2. At the top of the site, click Organization and click the Members tab.
3. Search for members by name or username and apply filters to narrow the members list. Sort the list as desired, such as by name or last login date.
4. Click the More options button in the member's row and click Manage add-on licenses.

   Tip:

   To change multiple members at once, check the box next to the name of each member for whom you want to assign or unassign the same add-on licenses. You can select up to 100 members at a time. The selected set is maintained while you search and filter all the members in your organization, even across multiple pages. If necessary, click the members selected drop-down menu to review and revise your selection once you've modified your initial search or filter. Above the list of members, click Manage add-on licenses.

5. In the window that appears, select or deselect the add-on licenses that you want to change.
   • If you selected multiple members, you can only assign add-on licenses that are compatible with all the selected members' user types. If necessary, click the members selected drop-down menu to remove any members with an incompatible user type. To review what's compatible with your organization's user types, go to the Licenses tab and click User types.
   • You cannot unassign ArcGIS Pro or ArcGIS Drone2Map licenses for members who checked out a license.
6. Click Save.

Configure user type extensions

User type extensions are licenses that extend the capabilities of ArcGIS Enterprise for specific users in an organization. They can be included as part of a user type or as an add-on license. For example, ArcGIS Utility Network is a user type extension that you can assign to individual members of an organization who work with the utility network.

Assign a user type extension license on the Licenses tab

To assign a user type extension license to a member of the organization on the Licenses tab, do the following:

1. Verify that you are signed in as an administrator of your organization or a member of a custom role with the privilege to manage licenses.
2. At the top of the site, click Organization and click the Licenses tab.
3. Click the Add-on licenses tab.
4. In the User type extensions section, find the license you want to manage. Click Manage.

   You can also click Compatible user types to see the list of user types that are compatible with the extension, based on the privileges granted to those user types.

5. Turn on the license assignment next to each member and choose whether or not you want to notify the member by email. To assign the specified user type extension license to all applicable members that appear on the page, click Manage all on page.

   If you can't assign the license to a particular member because it's not compatible with their user type or role, you can update user types and roles on the Members tab, or you can assign them a role with the privileges required for the capabilities provided by the extension.

6. To unassign a license, turn off the license assignment next to each member. To unassign the specified user extension license from all applicable members, turn on the filter to show only members with that license assigned and click Manage all on page.

You can also manage user type extensions from the Members tab.

Assign a user type extension license on the Members tab

To assign a user type extension license to one or more members of the organization on the Members tab, do the following:

1. Verify that you are signed in as an administrator of your organization or a member of a custom role with the privilege to manage licenses.
2. At the top of the site, click Organization and click the Members tab.
3. Search for members by name or username and apply filters to narrow the members list. Sort the list as desired, such as by name or last login date.
4. Click the More options button in the member's row and click Manage add-on licenses.

   Tip:

   To change multiple members at once, check the box next to the name of each member for whom you want to assign or unassign the same add-on licenses. You can select up to 100 members at a time. The selected set is maintained while you search and filter all the members in your organization, even across multiple pages. If necessary, click the members selected drop-down menu to review and revise your selection once you've modified your initial search or filter. Above the list of members, click Manage add-on licenses.

5. In the window that appears, select or deselect the user type extension licenses that you want to change.

   If you selected multiple members, you can only assign user type extension licenses that are compatible with all the selected members' user types. If necessary, click the members selected drop-down menu to remove any members with an incompatible user type. To review what's compatible with your organization's user types, go to the Licenses tab and click User types.

6. Click Save.

Release a checked-out license

If a user checks out a license for use in a disconnected environment and the device using the license is lost or destroyed, you'll need to release the license using the Portal Administrator Directory. This frees the outstanding license and allows the user to check out a new license or use ArcGIS Pro or Drone2Map in a connected environment.

1. Open a web browser and sign in to the Portal Administrator Directory as an administrator of your organization.

   The URL is formatted as https://portal.domain.com:7443/arcgis/portaladmin.

2. Click Home > License > Release License.
3. Type the username of the user who checked out the license (for example, jcho).
4. Click Release License.

Considerations for managing licenses

Keep the following in mind when managing licenses:

• If an app is included with a member's assigned user type, you don't need to assign the member an add-on license for that app. For example, a member assigned a GIS Professional user type already has a license for ArcGIS Pro, so you don't need to assign ArcGIS Pro to that member as an add-on license. If you're not sure which apps a member can already access, view their profile to see the licenses included with their user type and any assigned add-on licenses. (Go to the Organization page and click the Members tab. Find the member whose profile you want to view, click the More options button , and click View profile.)
• Your organization must have licenses available for ArcGIS Pro or add-on licenses such as ArcGIS Navigator before you see those products on the Licenses tab and can manage add-on licenses for those products.
• Organizations requiring more control over offline usage of ArcGIS Pro can prevent all ArcGIS Pro licenses in the organization from being taken offline. To do this for your organization, an administrator or a member with licensing privileges must enable the Prevent members from taking ArcGIS Pro offline setting in the ArcGIS Pro section of the Licenses tab. ArcGIS Pro users who are already working offline when this setting is enabled will be allowed to check back in, but any future attempts to take an ArcGIS Pro license offline will generate an error.
• You can configure email settings for your organization's administrative contacts to receive automatic email notifications when licenses in your organization are about to expire.
• Each product has a corresponding card on the licenses page that shows the number of add-on licenses available to assign and compatible user types.
• It is possible for your organization to exceed the number of licenses available, resulting in a negative number available. This can happen if you assign licenses to your members but are later entitled to fewer licenses, such as if you make changes to your maintenance agreement or you are using trial licenses. Upon the expiration of any license in your organization, you must unassign the expired license so your organization's members are only assigned valid licenses. Members with an expired user type will not be able to sign in. Members with an expired add-on license will not be able to use the license.