This page last changed on Sep 07, 2011 by pwatson.
JIRA 4.0 is the first major Atlassian application that can incorporate OpenSocial-compliant gadgets, such as Confluence gadgets onto its dashboard. This page explains how to add a Confluence gadget to the dashboard of a JIRA 4.0+ installation. To add a Confluence gadget to a JIRA dashboard, complete the sections below in order. On this page: Create an Application Link Between Confluence and JIRAIf your Confluence gadgets need to access user-restricted Confluence data, then your Confluence administrator must first establish an Application Link between your Confluence site and the JIRA site. For more information about configuring an Application Link between Confluence and other web applications, refer to Configuring OAuth Authentication for an Application Link. If you only need to access anonymously accessible Confluence data, then you can proceed to Finding a Confluence Gadget's URL, below.
Finding a Confluence Gadget's URLThe Confluence gadget's URL is the gadget's XML specification file. These URLs look something like this: To find a Confluence gadget's URL: - Choose Browse > Confluence Gadgets. The 'Confluence Gadgets' window will open.
The 'Confluence Gadgets' window displays a list of available Confluence gadgets in your Confluence installation, as shown in the screenshot below. By default, Confluence only includes a few gadgets. However, if your Confluence administrator has installed more Confluence gadgets (typically as Confluence plugins), these will also appear in this list. If a scrollbar is available, use it to find the gadget you want. - After finding your gadget, use the Gadget URL link to copy the gadget's URL to your clipboard. Many operating systems and browsers allow you to do this by right-clicking the Gadget URL link and copying it using the context menu.
Screenshot: Finding a gadget's URL

Adding a Confluence Gadget to a JIRA server's Gadgets DirectoryTo add a Confluence Gadget to the Gadgets Directory in JIRA: - Go to the dashboard by clicking Dashboard at the top left of the screen.
- The dashboard will appear. Click Add Gadget.
- The 'Add Gadget' screen appears, showing the list of gadgets in your directory. See screenshot 1 below. Click Add Gadget to Directory.
You will only see this button if you have administrator permissions for your dashboard. - The 'Add Gadget to Directory' screen appears. See screenshot 2 below. Paste the gadget URL (which you copied to your clipboard above) into the text box.
- Click Add Gadget.
- 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 Confluence Gadget to the JIRA Dashboard | In the procedure below, 'your Atlassian dashboard' and 'your Atlassian application' refers to the JIRA Dashboard and application, respectively. |
You can add a gadget from the directory of gadgets that are available to your Atlassian application.
To add a gadget to your Atlassian dashboard,
- Go to the dashboard by clicking the 'Dashboard' link or the 'Home' link at the top left of the screen.
- The dashboard will appear, looking something like screenshot 1 below. Click 'Add Gadget'.
- The 'Add Gadget' screen will display a list of available gadgets in your gadget directory, as shown in screenshot 2 below. 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.
- When you have found the gadget you want, click the 'Add it Now' button to add the gadget to your dashboard.
Screenshot 1: An Atlassian dashboard
Screenshot 2: Adding a gadget from the gadget directory

 | Adding a Gadget to the Directory of Available Gadgets
You need to have administrator privileges to add a gadget to the list of available gadgets. 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. Please refer to the Gadgets and Dashboards Administration Guide. |
All Atlassian gadgets
|