Documentation for GreenHopper 6.2.x. Documentation for other versions of JIRA Agile is available too.
GreenHopper is now called JIRA Agile. Learn more.
In Work mode, a board displays vertical columns. By default, each board contains three columns, called 'To Do', 'In Progress' and 'Done'. You can add, delete, rename or move these columns if you wish. You can also choose which JIRA workflow status(es) each column is mapped to, and whether any constraints apply to each column.
Note that only the owner of a board (or a person with the 'JIRA Administrators' global permission) can configure a board's columns.
To edit a board's columns:
Click the Columns tab.
Edit the columns as described in the following table and Screenshot 1 (below).
To do the following: | Do this: |
---|---|
Add a new column | Click the Add Column button at the right of the page. A new column named 'New Column' is added in the 2nd-last column position. If you are using Simplified Workflow, then a new status will automatically be created to match your new column. |
Change the name of a column | Click in the name area of the column, modify the existing name and press Enter. |
Delete a column | Click the trash-can icon at the top-right of the column. |
Move a column | Hover over the horizontal 'grid' icon, then drag the column left or right to its new position. Wait until other columns have shifted position before dropping the selected column to its new position. |
Screenshot 1: the 'Board Configuration' screen — 'Columns' tab.
The number in brackets after the status name shows the number of issues currently in that status.
By default, a board's columns are mapped to the default JIRA statuses as shown in the following tables. You can change this if you wish. For example, if you are using additional, customised JIRA statuses, you will probably want to map them to appropriate columns in your board.
If your board's project is using the JIRA default workflow:
Default column | Default mapped JIRA statuses |
---|---|
To Do | Open, Reopened |
In Progress | In Progress |
Done | Resolved, Closed |
... or ...
If your board's project is using Simplified Workflow:
Default column | Default mapped JIRA statuses |
---|---|
To Do | To Do |
In Progress | In Progress |
Done | Done |
To edit the mapping of JIRA workflow statuses to columns of a board:
Click the Columns tab.
Change the mapping statuses as described in the following table and Screenshot 1 (above).
To do the following: | Do this: |
---|---|
Map a status to a column | Drag a status from the Unmapped column to the appropriate column on the right. |
Unmap a status from a column | Drag a status from its current column on the right to the Unmapped column on the left. |
Change the column mappings of a status | Drag a status from its original column to its relevant new column. |
All statuses configured in the JIRA server are available from the board Configuration page. However, some statuses (in particular, custom statuses) may not be available for issues on your board if the JIRA workflow(s) used by these issues do not utilise those statuses.
See the Tutorial - Adding a Column to a Board for an example of creating a new column and mapping it to a new JIRA status.
If your board is using Simplified Workflow:
Click the Columns tab.
Click the Add Status button at the right of the page.
Note that the Add Status button is only available if you have the JIRA 'Project Administrator' permission for this board's project.
If your board is not using Simplified Workflow, please follow the Tutorial - Adding a Column to a Board.
If your board is using Simplified Workflow:
Click the Columns tab.
Drag the status to the Unmapped Statuses column.
Click the delete icon (trash can) for the status you wish to remove.
Note: that you can only delete a status if you have the JIRA 'Project Administrator' permission for this board's project.
You can only delete a status if there are no issues that currently have that status.
If any other workflows are using this status then the status will be removed from your workflow, but not deleted.
If your board is not using Simplified Workflow, you can only delete a status vis the JIRA administration interface — please see the JIRA documentation on Configuring Workflow.
Constraints specify how many issues a column can contain. You can specify constraints for all columns, or just some of them.
You can choose to exclude sub-tasks from the count. This is useful if you want to constrain the number of major tasks (stories) your team is working on, rather than the total number of individual tasks. This is likely to be more relevant to Scrum teams than to Kanban teams.
To set 'Maximum' and 'Minimumum' constraints for a column of a board:
Click the Columns tab.
Edit the constraints as described in the following table and Screenshot 1 (above).
To do the following: | Do this: |
---|---|
Enable column contraints | In the Column Constraint drop-down, select either Issue Count or, if you don't want to include sub-tasks in the column count, Issue Count, excluding sub-tasks. |
Set a column's 'Min' constraint | Click the yellow box at the top of the column, type the new value and press Enter. |
Set a column's 'Max' constraint | Click the red box at the top of the column, type the new value and press Enter. |
Remove a column's 'Min' constraint | Click the yellow box at the top of the column, delete the current value and press Enter. |
Remove a column's 'Max' constraint | Click the red box at the top of the column, delete the current value and press Enter. |
Remove constraints for all columns | In the Column Constraint drop-down, select None. |