JIRA is now available as three separate applications, JIRA Software, JIRA Service Desk, and JIRA Core. For more information on administering these applications, refer to the Administering JIRA Applications documentation.

Adding a Gadget to the Directory

The JIRA gadget directory displays all the gadgets that are available for JIRA users to add to their dashboard.

You need to have administrator privileges to add a gadget to the directory. If you have permission to add gadgets to and remove gadgets from the directory itself, you will see the 'Add Gadget to Directory' and 'Remove' buttons on the 'Add Gadget' screen, as shown below.

On this page:

Security implications

Add only gadgets from sources that you trust. Gadgets can allow unwanted or malicious code onto your web page and into your application. A gadget specification is just a URL. The functionality it provides can change at any time.

There are two types of gadgets: those that must be installed as plugins, and those that can be added as simple gadget URLs.

Adding a Gadget that is Not a Plugin

If the gadget is hosted on another server and can be added to the directory as a simple URL, then you can simply add it via your dashboard's 'Add Gadget' option.

To add a gadget to your directory,

  1. First you need to find the URL for the gadget's XML specification file. Gadget authors and publishers make their gadget URLs available in different ways. Below are the instructions for an Atlassian gadget and a Google gadget.

    • Follow the steps below if you need to find the URL for a gadget that is published by an Atlassian application, such as JIRA or Confluence: A gadget's URL points to the gadget's XML specification file. Gadget URLs are shown on the 'Gadget Directory' screen that is displayed when you click 'Add Gadget'. In general, a gadget's URL looks something like this:

      If the gadget is supplied by a plugin, the URL will have this format:
      For example:

      To find a gadget's URL in JIRA:

      • Go to your dashboard by clicking the 'Dashboards' link at the top left of the screen.
      • Click 'Add Gadget' to see the list of gadgets in the directory.
      • Find the gadget you want, using one or more of the following tools:
        • Use the scroll bar on the right to move up and down the list of gadgets.
        • Select a category in the left-hand panel to display only gadgets in that category.
        • Start typing a key word for your gadget in the 'Search' textbox. The list of gadgets will change as you type, showing only gadgets that match your search term.
      • Right-click the 'Gadget URL' link for that gadget and copy the gadget's URL into your clipboard.

      To find a gadget's URL in Confluence:

      • Open the 'Browse' menu and click 'Confluence Gadgets' to see the list of available Confluence gadgets.
      • Find the gadget you want.
      • Right-click the 'Gadget URL' link for that gadget and copy the gadget's URL into your clipboard.
    • Follow the steps below if you need to find the URL for a Google gadget:
      1. Go to the Google gadget directory. (You can also get there by clicking 'Add Stuff' from your iGoogle home page.)
      2. Search for the gadget you want.
      3. Click the link on the gadget to open its home page.
      4. Find the 'View source' link near the bottom right of the page. Right-click the link and copy its location to your clipboard. This is the gadget's URL.
  2. Now you can add the gadget to your directory. Go to the dashboard by clicking the 'Dashboard' link or the 'Home' link at the top left of the screen.
  3. The dashboard will appear. Click 'Add Gadget'.
  4. The 'Add Gadget' screen appears, showing the list of gadgets in your directory. Click 'Add Gadget to Directory'.
    (info) You will only see this button if you have administrator permissions for your dashboard.
  5. The 'Add Gadget to Directory' screen appears. Type or paste the gadget URL into the text box.
  6. Click 'Add Gadget'.
  7. The gadget appears in your gadget directory. (It will be highlighted for a short time, so that you can see it easily.)

 Adding a Gadget that must be Installed as a Plugin

If the gadget must be installed as a plugin, you cannot add it via the gadget directory user interface.

Instead, you will need to follow the instructions for adding a plugin, as described in Managing JIRA's Plugins.

Once you have installed your plugin, the gadget will automatically appear in the directory.


The big list of Atlassian gadgets

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

3 Archived comments

  1. User avatar

    Gede Suparsa

    If the gadget is hosted externally, does the JIRA server need to be configured for internet access (ie proxy settings if required)?

    11 Aug 2010
  2. User avatar


    I have a user that does not have the + Add Gadget option on their main dashboard.  Is there some kind of permission I need to check that would allow him to see this option on the dashboard?

    12 Sep 2012
  3. User avatar

    Michael Richards

    As a point of clarity in the documentation, it seems that adding gadgets to the directory requires the System Administrator privilege in JIRA, rather than regular Administrator.

    11 Oct 2013
Powered by Confluence and Scroll Viewport