Select Your Product:
Licensing your Marketplace Add-ons
Note: If you start an evaluation or purchase an add-on through UPM 2.0 or higher, typically you won't need to manually install the add-on and enter a license key. Instead, UPM guides you through the process and automates the download, installation, and license key entry. If you have an earlier version of UPM or downloaded a JAR from the Atlassian Marketplace website, you can use the procedure described on this page to manually locate and copy an add-on license.
Download and install the add-on
You must have administrative rights in the Atlassian product to install an add-on.
If you already downloaded a JAR from the Atlassian Marketplace website you can upload it by choosing Upload Plugin on the Manage Plugins page (Install Plugins page or Install page in UPM prior to 2.3). Otherwise use the following procedure to install an add-on.
|UPM 1.x||UPM 2.0+|
Locate, copy and enter your license key
After you start an evaluation or purchase an add-on, you can log into my.atlassian.com to access all your license keys.
|UPM 1.x||UPM 2.0+|
Licensing and your Atlassian products
When you upgrade or renew your JIRA license, you will receive a new license key. You will need to update your JIRA server with the new license key.
You can access your license key via http://my.atlassian.com
To update your JIRA license key:
- Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
Keyboard shortcut: 'g' + 'g' + start typing 'license' > System. Select License to view your existing JIRA license details.
- Paste your new license into this box.
You can retrieve existing licenses or generate an evaluation one by clicking the 'My Account' link.
- Click the 'Add' button to update the JIRA installation with the new license.
Screenshot : License Details
Do you have a user-limited license?
If you have a user-limited license (such as a starter license), then the user limit of your license will be displayed on the 'License Details' page. This field is periodically refreshed, but you can retrieve the latest user limit by clicking the 'Refresh' button.
Reducing your user count
You may want to reduce your user count in JIRA 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 all groups with the 'JIRA Users' global permission. This is described in the following knowledge base article: Unable to Create Issues Due to Exceeded License.
Alternatively, if you have connected JIRA to an LDAP directory, you may want configure JIRA to synchronise a subset of users from LDAP rather than all users. This is described in Reduce the number of users synchronised from LDAP to JIRA. However, this can be a complicated procedure and we recommend that you do not use this method unless necessary.
Note, if you exceed the user count allowed by your JIRA license, your users will not be able to create issues.
To specify your GreenHopper license details,
- Log in as a user with the 'JIRA System Administrators' global permission.
- Click the 'cog' icon on the top bar (or click Administation if using an older version of JIRA) and select Add-ons. The Universal Plugin Manager (UPM) page will be displayed.
- On the Purchased Add-ons page, click Check for Purchases then locate GreenHopper.
- Click the Manage button. The details for the GreenHopper add-on will display.
Your Support Entitlement Number (SEN) is also shown on this screen.
- Paste your license into the License Key field and click Update.
You can copy your GreenHopper license from https://my.atlassian.com, where you can either generate a new Evaluation License Key, or retrieve your old License Key if you already have one.
Screenshot: GreenHopper License Information
Your license entitles you to run Confluence and be eligible for support and upgrades for a specified period. It also defines the number of users who are entitled to use Confluence.
To quickly check the status of your license you can go to > General Configuration > Atlassian Support Tools > Health Check.
You'll need need Confluence Administrator or System Administrator permissions to view and edit your license.
Viewing your license details
To view your Confluence license:
- Go to > General Configuration.
- Choose License Details in the left-hand panel.
The License Details page tells you:
- The type of license (for example: Commercial, Academic, Community, or Evaluation).
- Number of users you are licensed for, and how many are currently in use.
- Your license expiry date, for support and upgrade eligibility.
- Your server ID which is generated when you install Confluence for the first time and remains the same for the life of the installation (including after upgrades or changes to your license).
- Your support entitlement number (SEN).
Updating your license
If you change your license (for example to a license with more users), or migrate from Confluence Cloud and you will need to update your license.
To update your Confluence license:
- Go to > General Configuration > License Details
- Enter your new license in the License field.
- Choose Save.
Understanding the user count for your license
The number of registered users allowed on your Confluence site may be limited, depending on your license type.
The License Details page will indicate the number of users currently signed up (your registered user count). It:
Screenshot: License details
- includes only users who have the 'can use' global permissions for the Confluence site.
- does not include anonymous users, who may access your Confluence site if you have allowed anonymous access.
- does not include deactivated users.
Exceeding your licensed user count
If you exceed the number of users included in your license, your Confluence instance will become read-only, that means no users will be able to create or edit content until you reduce the number of users.
Reducing your user count
You can reduce your user count by removing or deactivating users who do not require access to Confluence. See Deleting or Deactivating Users.
If you have connected Confluence to an LDAP directory, you may want configure Confluence to only synchronise a subset of users from LDAP rather than all users. See How to change the number of users synchronized from LDAP to Confluence in the Knowledge Base. This can be a complicated process and we recommend that you only use this method if necessary.
Downgrading your license
If you decide to downgrade your Confluence license to pay for fewer users you need to ensure that the number of users currently signed up (as shown on the License Details page) is lower that the number allowed by your new license before your apply the new license.
If you have more users than your new license allows you will need to reduce your user count before applying the new license.
Finding your Support Entitlement Number (SEN)
You can find your Support Entitlement Number (SEN) in three places:
- In Confluence - go to > General Configuration > License Details)
- At my.atlassian.com
- On your Atlassian invoice.
See Finding Your Support Entitlement Number for more general information about how Atlassian Support uses this number.