Documentation for GreenHopper 6.2.x. Documentation for other versions of JIRA Agile is available too.
GreenHopper is now called JIRA Agile. Learn more.

Configuring a board allows you to edit the mapping of JIRA workflow statuses to columns of a board, as well as edit the columns, swimlanes, filter and quick filters of a board, and customise the card colours and displayed issue fields.

(info) Note that only the owner of a board (or a person with the 'JIRA Administrators' global permission) can modify its configuration.

Accessing a board's configuration

To configure a board:

  1. Select Agile > Manage Boards from the top navigation bar.
  2. The Manage Boards screen will be displayed (see Screenshot 1 below). Click the Configure link corresponding to the board of interest.
  3. The Board Configuration screen will be displayed (see Screenshot 2 below). Select the tab corresponding to the area of interest (Filter, Columns, etc).

(tick) Alternatively, to quickly get to the Configuration screen for the board you are currently viewing, simply click the 'cog' icon at the top-right of the screen and select 'Configure' from the drop-down.

Screenshot 1: the 'Manage Boards' screen.

Screenshot 2: the 'Board Configuration' screen — 'Filter' tab.

 


Renaming a board

To change the name of your board:

  1. Go to the Configuration screen for your board (see above).
  2. Click the 'pencil' icon (which will appear when you hover) to edit the name of your board. Press the Enter key when finished.

Changing a board's owner

A board's owner is the only person who can change the configuration of a board along with JIRA administrator users. By default, the owner of a board is the person who created it. If you are the owner, or a JIRA administrator, you can change the owner of a board.

To change the owner of your board:

  1. Go to the Configuration screen for your board (see above).
  2. Click the 'pencil' icon (which will appear when you hover) to edit the owner of the board. Press the Enter key when finished.

(info) Note that you will want to also give the new owner rights to manage the JIRA filter on which the board is based – see the JIRA documentation on Managing Shared Filters.

Sharing a board

A board is available to all users who can view the saved filter on which the board is based. (Note that they will also need 'Browse' permission for the project(s) whose issues are shown on the board.)

If you wish to share a board with different people, you will need to either edit the saved filter (see the JIRA documentation on issue filters), or choose a different filter (see Configuring Filters).

Note that only the owner of the board or an Administrator may modify a board's configuration.