Issues Overview

Issues Overview

Issues help you track problems, blockers, and concerns that need resolution.

Updated over a month ago

What are Issues?

Issues represent:

  • Bugs - Technical problems

  • Blockers - Things preventing progress

  • Risks - Potential problems

  • Concerns - Questions or uncertainties

  • Defects - Quality issues

Viewing Issues

Issue List

Navigate to Issues to see all issues in your organization.

The list shows:

  • Issue title

  • Status

  • Priority

  • Assigned project(s)

  • Created date

Project Issues

1

Open a project.

2

Go to the Issues tab.

3

See issues linked to that project.

Issue Groups

Issues can be organized into groups for better management:

  • View issues by group

  • Filter by group

  • Create custom groups

Creating Issues

Create an Issue

1

Navigate to Issues or a project's Issues tab.

2

Click + New Issue.

3

Fill in the details:

  • Title - Brief description of the issue

  • Description - Full details

  • Priority - Critical, High, Medium, Low

  • Group - Category or type

  • Project - Associated project (optional)

4

Click Create.

Quick Create

1

From the issues list, type in the quick input.

2

Press Enter.

3

Add details later.

Issue Properties

Property

Description

Title

Brief description

Description

Full details and context

Status

Current state

Priority

Importance level

Group

Category or type

Project(s)

Linked projects

Linked Items

Related tasks, requirements, etc.

Issue Status

Status

Meaning

Open

Issue is active, needs attention

In Progress

Being worked on

Pending

Waiting for something

Resolved

Fixed or addressed

Closed

No longer active

Issue Priority

Priority

Meaning

Critical

Immediate attention required

High

Important, address soon

Medium

Normal priority

Low

Address when possible

Linking Issues

Issues can be linked to many items for traceability:

  • An issue can affect multiple projects

  • Project teams see relevant issues

  • Show which tasks are blocked

  • Track issue resolution progress

  • Connect issues to business requirements

  • Impact assessment for changes

  • Reference relevant documentation

  • Attach evidence or reports

  • Connect to meeting notes

  • Reference discussions about the issue

1

Open the issue.

2

Click Link and choose the item type.

3

Select the item to link.

4

View all links in the issue details.

Issue Groups

Organize issues by creating groups.

Create a Group

1

Go to Issues.

2

Click Manage Groups.

3

Click + New Group.

4

Enter a name (e.g., "Technical Bugs", "Process Issues").

5

Click Create.

Assign to Group

1

When creating or editing an issue, select the Group dropdown.

2

Choose a group.

3

The issue appears under that group.

Updating Issues

1

Open the issue.

2

Edit any field.

3

Changes save automatically.

Status changes are logged for audit purposes.

Issue Heatmap

1

Open a project.

2

View the issue heatmap.

3

See patterns of issue creation and resolution.

4

Identify problem periods.

Best Practices

Writing Good Issue Titles

  • Be general

  • Example: "Authentication & SSO"

Last updated

Was this helpful?