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

Skip to end of metadata
Go to start of metadata

The Planning Board enables you to prioritise and schedule issues. Issues are represented as cards, colour-coded according to issue type (e.g. Story, Bug, Task, Improvement, etc). Version, component and assignee information is summarised at the right of the Planning Board, allowing you to quickly gauge the backlog for each. Project administrators can add new versions on the Planning Board, to create product, release and sprint backlogs.

You can also manage cards (issues) via the Planning Board. Issues can be easily scheduled and prioritised by dragging and dropping them. You can also perform common JIRA tasks, such as adding, updating and deleting issues (provided you have the appropriate JIRA permissions).

To view the planning board for your project,

  1. Login to JIRA.
  2. Click the 'Agile' link's down-arrow in the top navigation bar and select 'Planning Board' from the resulting dropdown menu. The 'Planning Board' will be displayed.
  3. Select your project from the project dropdown in the top left of the planning board (above the 'Planning Board' dropdown), if it is not already selected. The 'Planning Board' will refresh with information for your project.

(tick) Tip: you can also jump directly to the Planning Board when viewing an issue in JIRA, by selecting 'Planning Board' from the 'More Actions' menu.

Screenshot: GreenHopper Planning Board (click to view larger image)

The screenshot above shows an example Planning Board. To learn more about each part of the Planning Board, please see the sections below and the documentation linked from those sections.

Planning Board — Navigation Bar

Gliffy Zoom Zoom

  1. Board dropdown — Select another GreenHopper board to view (Task Board, Chart Board or Released Board).
  2. Project dropdown — Select the project whose issues you wish to view.
  3. Context dropdown — Select the context by which to filter issues ('Default', 'On the fly', or other contexts you have created). You can also select 'Manage' to edit your existing contexts, or 'New' to create a new context. Read more about contexts in Using Contexts to Filter and Highlight Issues.
  4. Refresh icon — Click the icon to reload the contents of the Planning Board.
  5. Viewing Mode dropdown — Select the viewing modefor your Planning Board:
    • 'Project'
    • 'Component'
    • 'Version'
    • 'Assignee'
  6. Viewing Mode sub-dropdown — Select the sub-category of the viewing mode. Read more about viewing modes in Using Planning Board Modes.
  7. 'New Card' — Click the 'New' link to create a new card (i.e. issue). For details see Creating an Issue in GreenHopper.
  8. 'Views' dropdown — Select from the following:
    • 'Cards' — Displays a detailed view of every issue. Read more about the 'Cards' view in Viewing Issues in GreenHopper.
    • 'Summaries' — Displays a compact view of every issue. Read more about the 'Summaries' view in Viewing Issues in GreenHopper.
    • 'List' — Displays a table with one issue per line. Read more about the 'List' view in Viewing Issues in GreenHopper.
    • 'Full Screen' — Hides the JIRA header so as to fit more cards on the screen.
  9. 'Tools' dropdown — Select from the following:
  10. Pagination — Click a page-number to go to the desired page.
  11. Quick Filters— Click the following filters to refine the collection of displayed cards:
    • 'Only My Issues' — Only display issues which are assigned to you.
    • 'Only Pending Issues' — Exclude any issues that are part of a child version or component. (This filter is available on the Planning Board only)
    • 'Hide Done Issues' — Only display issues which have not yet been resolved.
    • 'Hide Sub-tasks' — Only display issues which are not sub-tasks of other issues.
      (info) 'Quick Filters' only affect the cards that appear on the current board. Unlike context filters, these filters do not affect the values presented in the Statistics Column.
  12. Search — See Searching for Issues on a Board.

Planning Board — Issues

Gliffy Zoom Zoom
  1. Released — The icon indicates that this issue was resolved in a sub version that has been released, but it is still shown in the parent version as it is assigned to that version as well.
  2. Flagged — The icon indicates that this issue has been flagged for special attention.
  3. Issue Type and Priority — These two icons indicate the Type of this issue (e.g. Task, Bug, Improvement, etc) and its Priority (e.g. Critical, Major, Minor).
    Click the icon (which will appear when you hover over the Issue Type or Priorityicons) to display a drop-down menu containing:
    • Update Priority --— Click to edit the Priority field for this issue.
    • Add Sub-task — Click to add a sub-task to this issue (if sub-tasks are enabled).
    • Edit in JIRA — Click to open the JIRA 'Edit Issue' screen, on which all issue fields are available for editing.
    • Flag as Impediment — Click to flag this issue for special attention.
    • Comment — Click to quickly add a comment to this issue.
    • Delete — Click to delete this issue.
  4. Issue Key --— Click to view the details for this issue.
  5. Editable Fields — Click the icon (which will appear when you hover) to edit the following fields:
    • Summary
    • Fix Version
    • Assignee
    • Status
  6. Sub-tasks — Click to display a dialog box showing the issue's sub-tasks. You can drag-and-drop subtasks within this box to re-order them.
  7. 'Work Logged' (if applicable) — the amount of time that has been spent on this issue. Click to log work on this issue.

Planning Board — Statistics Column

To select a box, click inside it and once selected, the box turns yellow. The content on the rest of the Board you are viewing will be updated to show the data associated with that box.

Gliffy Zoom Zoom
  1. 'Add' (Planning Board in 'Version' mode and Chart Board only. Visible to administrators only.) — Click to create a new version. Read more in Adding a Version.
  2. 'Statistics' (Planning Board in 'Version' mode and Chart Board only. Visible to administrators only.) — Click to configure statistics displayed in the boxes in this column. Read more in Configuring a Custom Statistic.
  3. 'Collapse' — Click the icon to show only the title of each box in the Statistics column.
  4. 'Expand' — Click the icon to show the full details for each box in the Statistics column.
  5. 'Hide' — Click the icon to hide the Statistics column and display the 'Issues' section of the Board in full screen width.
  6. Name ('Version', 'Assignee', 'Component', 'Project Overview' modes only. Visible to administrators only.) — Click the icon (which will appear when you hover this area of the selected box) to edit the version or component name.
  7. Actions menu — Click the icon (which will appear at the top right of the selected box when you hover over this area) to display a drop-down menu. This drop-down menu can contain the following items. Be aware that some of these are not available on certain GreenHopper Boards:
    • 'Toggle visibility' — Click to show/hide the current box in the Statistics column.
    • 'Issue Navigator' — Click to go to the Issue Navigator.
    • 'Go to Task Board' ('Version' mode only) — Click to go to the Task Board.
    • 'Go to Planning Board' ('Version' mode only) — Click to go to the Planning Board.
    • 'Go to Chart Board' ('Version' mode only) — Click to go to the Chart Board.
    • 'Non Working Days' ('Version' mode only. Visible to administrators only.) — Click to edit the Non Working Days for a specific version. (Note: to edit the Non Working Days for the whole of GreenHopper, see Specifying your General Configuration.)
    • 'Print Cards' (Planning Board in 'Version' mode only) — Click to print the displayed issues. For details please see Printing Issues in Card Form.
    • 'Print Chart' (Chart and Released Boards only) — Click to print the currently viewed chart.
    • 'Excel (Chart Data)' ('Hour Burndown Chart' on the Chart Board only) — Click to download a csv version of the chart's data.
      (info) You may need to refresh the contents of the chart board first in order to see this menu option.
    • 'Release' ('Version' mode only. Visible to administrators only.) — Click to release the version. A snapshot of all of the charts associated with this version will also be captured (before any issues are swapped). You will be able to access these snapshots via your Released Board.
      (info) If the version contains unfinished issues, you will be prompted to either ignore them and proceed with the release, or move the unfinished issues to another version of your choice.
    • 'Recompute' (Released Board only; 'Project Overview' mode only. Visible to administrators only.) — Click to refresh the Released Board. (Note: the Project Overview is the only chart that is stored statically; all other charts are generated dynamically.)
    • 'Create Wallboard' (Planning Board only; 'Project Overview' mode only) — Click to create a Wallboard.
      1. A wallboard will be created with the name '<Project name> (autogenerated)' and displayed. Your wallboard is a new page on your JIRA dashboard, and will contain:
      2. Select 'View as Wallboard' from the 'Tools' drop-down on your JIRA dashboard, and stare in awe at your fresh new wallboard. For optimal use of screen real-estate, enter full-screen mode on your browser (F11 in Firefox 3.6 and Chrome 5; Safari requires a plugin to enable full-screen mode) and refresh. Wallboards are optimised for 1920x1080 and 1920x1200 screens, but should work in some other resolution modes.
  8. Progress of the version ('Version' mode only) — the green bar indicates the percentage of issues that are complete, the yellow bar indicates the percentage of issues in progress, the red bar indicates the percentage of issues that have not been started. Hover over the bar to see the exact percentages. Click on a coloured section of the bar to be taken to the Issue Navigator for the full list of issues in that colour.
  9. 'Parent' ('Version' & 'Component' modes only) — Click the icon (which will appear when you hover, if you are an administrator) to choose the parent version or component for the version. All issues under the version/component will also be a subset of the parent version/component, e.g. 'Version 1' could be set as the parent version of 'Version 1 milestone 1'. Read more in Setting Up a Component Hierarchy and Setting Up a Version Hierarchy.
  10. 'Start date' ('Version' mode only) — Click the icon (which will appear when you hover, if you are an administrator) to edit the start date for the version.
  11. 'End date' ('Version' mode only) — Click the icon (which will appear when you hover, if you are an administrator) to edit the end date for the version.
    (tick) Tip: The start date and end date are used to compute the various charts in GreenHopper.
  12. 'Release date' ('Version' mode only) — Click the icon (which will appear when you hover, if you are an administrator) to edit the JIRA release date for the version.
  13. Issue Type statistics — A summary of the number of issues of each type.
  14. Statistics based on the Task Board mapping — A summary of the number of issues in each status (based on the Mappings that your administrator has specified in the Task Board Settings).
  15. Time-tracking statistics — Only displayed if JIRA time trackingis enabled.
    • 'Time Remaining' — Click the icon (which will appear when you hover, if you are an administrator) to specify maximum and minimum limits for the amount of time remaining.
  16. Custom statistics — Displayed if any custom statistics have been created by the project administrator. (The red numbers, if shown, indicate that a statistic's constraint has been exceeded.) If custom statistics exist, you can click the icon to add them as markers on your Planning Board (see Using Statistical Markers to Group Issues).

(tick) Tip: Boxes that relate to child versions or components are attached below their parent version or component and are represented with a right-indented arrow, as shown by the 'Hardening Sprint' example in the screenshot above.

Icon

The content of the Statistics Column will differ depending on the viewing mode selected. For example, when 'Version' mode is selected (as shown in the image above), the 'Parent', 'Start Date', 'End Date' and 'Release Date' fields will be shown, and the 'Add' button will appear at the top of the column. You can read more about about viewing modes in Using Planning Board Modes.

Related Topics

Administrators should also see Adding a Version.