This page tells you how to move a gadget to different position on an Atlassian application's dashboard. These instructions assume that you are using an application that supports the new Atlassian Gadgets framework.

Currently, only JIRA provides a dashboard that supports gadgets. You will need JIRA 4.0 or later. Confluence does not yet support gadgets on its dashboard, but you can add gadgets to a Confluence page.

On this page:

Moving Gadgets Around on your Dashboard

You can drag a gadget and drop it onto a different place on your dashboard.

To move a gadget,

Go to your application's dashboard. In most cases, you will do this by clicking the 'Dashboard' link or the 'Home' link at the top left of the application screen.

Move your mouse pointer over the top frame of the gadget, where the pointer changes to a 'move' icon, such as a hand or a set of arrows

Click the top frame of the gadget and move your mouse to drag the gadget. As you move it across the dashboard, empty frames will open in places where you can choose to place the gadget. The frames contain the words 'Drag your gadget here'. The gadget you are moving will become slightly transparent, so that you can see the dashboard beneath it. See the screenshot below.

Release the mouse button to drop the gadget where you want it.

Screenshot: Moving a gadget

Adding and Removing Columns on your Dashboard

You can change the number of columns in your dashboard. If you reduce the number of columns, the gadgets already on the dashboard will move to fit into the new layout. If you increase the number of columns, the new columns will be empty until you move gadgets into them.

To change the number of columns in your dashboard,

Go to your application's dashboard. In most cases, you will do this by clicking the 'Dashboard' link or the 'Home' link at the top left of the application screen.

Click 'Edit Layout'. You can see this link at top right of the screenshot above.

The 'Edit Layout' popup window appears, as shown in the screenshot below. The popup window displays diagrams of the available dashboard layouts, representing the number of columns in each layout and the relative width of each column. Click one of the diagrams to select the layout you want.

Now you can drag and drop gadgets into the columns as described above.

Screenshot: Choosing a dashboard layout

Resizing Columns on your Dashboard

The dashboard's 'Edit Layout' feature allows you limited control over the width of the columns on your dashboard. To choose a wider left-hand or right-hand column, follow the steps described above for adding and removing columns and choose the layout that you want, based on the diagram in the 'Edit Layout' popup window, as shown in the screenshot above.

Notes about Different Dashboards

Differing Look and Functionality

The screenshots on this page show the basic Atlassian dashboard layout. The layout will be similar in all applications that support the new Atlassian Gadgets framework. However, there may be slight differences in the look and feel for a particular application and some applications may have additional functionality. For example, JIRA will allow you to create multiple dashboards on separate tabs. The extra functionality is described in the documentation for the application concerned.

Permission to Update a Dashboard

Your ability to update a dashboard depends on the application hosting the dashboard. Most applications will require you to log in before you can update the dashboard. Your ability to update the dashboard may then depend on the permissions assigned to your username.

Who Will See the Changes You have Made to the Dashboard?

This depends on the application hosting the dashboard:

In most cases, you will need to log in to the application before you can update the dashboard, and your updates will apply only to your personal dashboard.

Some applications allow dashboards that are shared by groups of people. If you have permission to update a shared dashboard, the other people sharing the dashboard will see your changes too.

If you have permission to update an application's default dashboard, your changes to the default dashboard will be seen by anyone who views that dashboard.