Licensing your JIRA applications

You can view and manage your JIRA application licenses on the Versions & licenses page. You may need to add or update your license if you:

  • change the type of license (for example you may want to purchase a full license when your evaluation license expires)
  • upgrade your user tier to accommodate new users
  • add a new license when your old license has expired
  • add a new license for a newly installed application

Before you begin

For all of the following procedures, you must be logged in as a user with the JIRA Administrators or System Administrators global permission.

Updating your JIRA license details

  1. Obtain the license key you want to update (you can do this by visiting my.atlassian.com or by contacting the member of your organization who handles IT product licensing).
  2. Choose > Applications.
  3. Select Versions & licenses to view license details for your installed JIRA applications.
  4. Locate the license you want to update, and click on the pencil icon to edit the license.
  5. Replace the existing license key with your new license key.
  6. Click the 'Update license' button to update the JIRA application with the new license.


(info) The updated license must be compatible with any other license(s) on your JIRA server.

To update your JIRA license key manually

  1. Obtain the license key you want to update (you may do this by logging in to http://my.atlassian.com separately, or contacting your organization's member who deals with licensing for IT products).
  2. Choose > Applications.
  3. Select Versions and licenses to view your existing JIRA applications license details.
  4. Locate the license you want to update, and click on to edit the license.
  5. Replace the existing license key with your new license key in the License field.
  6. Click the 'Update license' button to update the JIRA application with the new license.

Viewing your licensed user count

  1. Choose > Applications.
  2. Select Versions & licenses to view license details for your installed JIRA applications.
  3. Next to the application name you can view the number of licensed users, as well as the number of users already used.

When you are approaching (or have exceeded) the maximum number of users for your license, a warning banner is displayed:

(warning) If you exceed the user count allowed by your JIRA application's license, your users will not be able to create issues. To prevent this, either upgrade to a larger license or reduce your existing user count.

Upgrading to a larger license

  1. Choose > Applications. 
  2. Select Versions & licenses to view license details for your installed JIRA applications.
  3. Locate the license you want to upgrade.
    1. If you're near the maximum users for the license, you'll see a banner prompting you to upgrade. Click the Upgrade button to be redirected to the Atlassian order form.
    2. If you don't see the banner but still want to upgrade, visit the Atlassian order form directly.
  4. Complete your purchase at the desired user tier. When you're finished, you'll have a new license key in your my.atlassian.com account.
  5. Return to the Versions & licenses page and update your application with the newly purchased license key.

Reducing your user count

You may want to reduce the user count for a JIRA application if you have exceeded your user count or if you want to change to a lower-tier license to reduce costs.

The recommended method for reducing your user count in JIRA is to remove users from the groups associated with the application. Remember a user may be a member of multiple groups, but will only count as one user on your license. See Managing users for more information.

Alternatively, if you have connected JIRA to an LDAP directory, you may want configure JIRA to synchronize a subset of users from LDAP rather than all users. See Reducing the number of users synchronized from LDAP to JIRA applications for more information. However, this can be a complicated procedure and we recommend that you do not use this method unless necessary.

(warning) Note, if you exceed the user count allowed by your JIRA application's license, your users will not be able to create issues.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport