Documentation for JIRA 4.1. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

On this page:

Overview

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.

Security implications

Icon
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 'Add Gadget' screen. In general, a gadget's URL looks something like this:

      If the gadget is supplied by a plugin, the URL will have this format:
      http://my-app.my-server.com:port/rest/gadgets/1.0/g/my-plugin.key:my-gadget/my-path/my-gadget.xml
      For example:
      http://mycompany.com/jira/rest/gadgets/1.0/g/com.atlassian.streams.streams-jira-plugin:activitystream-gadget/gadgets/activitystream-gadget.xml

      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. See screenshot 1 below. 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. See screenshot 2 below. 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.)


Screenshot 1: Gadget directory with 'Add Gadget to Directory' button




Screenshot 2: Adding a gadget to the directory



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.

RELATED TOPICS

The big list of Atlassian gadgets