Skip to end of metadata
Go to start of metadata

Select Your Product:

Licensing your Marketplace Add-ons

 

If possible, we recommend you update to the latest version of the Universal Plugin Manager (UPM). The UPM is a system plugin in every Atlassian product. The latest UPM has many new features that enhance the ease of installing and managing add-ons. For more information on updating the UPM, see here.

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.xUPM 2.0+
  • Log in to your Atlassian product and navigate to the administration page.
  • Navigate to the Install page in the Plugins section.
  • Find the add-on you want to install by searching.
    The system displays a list of add-ons matching your search.

  • Click to expand the add-on description.

  • Choose the Install button.
    UPM downloads and installs the add-on for you. 
  • Follow the instructions to Locate, copy and enter your license key below.
  • Log in to your Atlassian product and navigate to the administration page.
  • Navigate to the Find New Plugins page in the Plugins section. (The Install Plugins page in UPM prior to 2.3)
  • Find the add-on you want to install by searching.
    The system displays a list of add-ons matching your search.

  • Click to expand the add-on description.

  • Choose Try (evaluation) or Buy (purchase).
    UPM downloads and installs the add-on for you. After installation, the system prompts you to get a license.
  • If you already have a license key, choose Cancel and follow the instructions to Locate, copy and enter your license key below.
  • Otherwise choose Continue and follow the automatic prompts to generate and install the license key.

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.

  • Log into your MyAtlassian account at my.atlassian.com.
    For the username, use the Technical Contact or Billing Contact email address you provided when purchasing or starting the evaluation of the add-on.
  • After you log in, navigate to the Licenses page and locate the relevant add-on.
  • Copy the license key (or simply keep the page open in your browser window).
  • Log in to your Atlassian product and navigate to the administration page. 
UPM 1.xUPM 2.0+
  • Navigate to the Manage Existing page in the Plugins section.
  • Locate your installed add-on in the list and click to expand it.
  • Choose the Configure button.
  • The system moves you to the configuration screen for the add-on.
  • Paste the key into the License field and choose Update.
  • Navigate to the Manage Plugins page in the Plugins section.
  • Locate your installed add-on in the list and click to expand it.
  • Paste the key into the License field and choose Update.

 

Licensing and your Atlassian products

JIRA

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.

(info) You can access your license key via http://my.atlassian.com

To update your JIRA license key:

  1. Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
  2. Choose > System. Select License to view your existing JIRA license details.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'license'
  3. Paste your new license into this box.
    (info) You can retrieve existing licenses or generate an evaluation one by clicking the 'My Account' link.
  4. 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.

(info) Need more information about licensing or want to find out more about starter licenses? Please see the Licensing FAQ and Starter Licenses page.

 

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.

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

 

JIRA Agile

To specify your GreenHopper license details,

  1. Log in as a user with the 'JIRA System Administrators' global permission.
  2. 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.
  3. On the Purchased Add-ons page, click Check for Purchases then locate GreenHopper.
  4. Click the Manage button. The details for the GreenHopper add-on will display.
    (info) Your Support Entitlement Number (SEN) is also shown on this screen.
  5. Paste your license into the License Key field and click Update.
    (info) 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.


License type must match the JIRA license type

Please note, if you are using a commercial (i.e. not an evaluation) license for GreenHopper, it must match your JIRA license. For example, if you have a JIRA 25 User Commercial license you must have a GreenHopper 25 User Commercial license. GreenHopper evaluation licenses do not need to match JIRA licenses.


(warning) The information on this page does not apply to GreenHopper OnDemand. To manage your GreenHopper OnDemand licenses, please log into your account at http://my.atlassian.com.

Screenshot: GreenHopper License Information

Confluence

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:

  1. Go to  > General Configuration.
  2. Choose License Details in the left-hand panel.

The License Details page tells you:

On this page:


Related pages:

  • 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:

  1. Go to  > General Configuration > License Details
  2. Enter your new license in the License field.
  3. 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

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.



  • No labels