Board Troubleshooting

Project Admins are also Board admins and have permissions to troubleshoot board issues.

1 Certain issues are not viewable on the board
2 Issue is not viewable when in a certain status
3 Issues are appearing that shouldn’t be on the board
4 Certain users cannot view the board
5 Not all issues are showing on the board

Certain issues are not viewable on the board

Cause: The board's filter is blocking some issues.

Resolution: Project admin can check the board filter in the General section of the board settings.

Is the filter shared appropriately? - check Shares section of the General board settings
1. The filter needs to be shared
2. The board should be shared with the project.

2. Does the filter pick up the expected issues when run in the filter navigator? - copy the filter from the Filter Query section of the board settings and run it in the issue navigator. Ferguson Prod Issue Navigator

3. Is the board located in the appropriate project and does it include the appropriate project - check the Location and the Projects in Board settings.

If the board filter retrieves issues based on an additional field like a custom field or label, ensure that each of the issues that should be shown in the board and their Epics has the correct custom field or label value.

Issue is not viewable when in a certain status

Cause: Status is not mapped to a column on the Board.

Resolution: Check the Board settings for unmapped statuses.

Under the Columns section of the Board settings, if statuses are unmapped you will get a warning with a link to show the column setup:

Project admin can map the columns in board's configuration to the correct status. Please refer to Configuring columns for more information.

Issues are appearing that shouldn’t be on the board

Cause: The board's filter is including those issues

Resolution: Update the filter to exclude the issues you don’t want to view.

Example to exclude sub-tasks:

Project = XXX AND issuetype in standardIssueTypes() {plus other filter criteria}

Example to exclude components

Project = XXX AND component != component name {plus other filter criteria}

or

Project = XX AND component not in (component 1, component 2) {plus other filter criteria}

Certain users cannot view the board

Cause: The user does not have the appropriate permissions to view or edit those issues.

Resolution: Project admin can verify the user in in either the Observer project role or the Team Member project role in order to view/work on issues.

https://fergusonprod.atlassian.net/wiki/spaces/TRAIN/pages/95715443

Not all issues are showing on the board

Cause: There may be a Quick Filter selected.

Resolution: Project admin can check if any Quick Filters are selected at the top of the board. - Configuring Quick Filters