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
Open a project
Go to the Issues tab
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
Navigate to Issues or a project's Issues tab
Click + New Issue
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)
Click Create
Quick Create
From the issues list:
Type in the quick input
Press Enter
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:
Link to Projects
An issue can affect multiple projects
Project teams see relevant issues
Link to Tasks
Show which tasks are blocked
Track issue resolution progress
Link to Requirements
Connect issues to business requirements
Impact assessment for changes
Link to Documents
Reference relevant documentation
Attach evidence or reports
Link to Activities
Connect to meeting notes
Reference discussions about the issue
Creating Links
Open the issue
Click Link and choose the item type
Select the item to link
View all links in the issue details
Issue Groups
Organize issues by creating groups:
Create a Group
Go to Issues
Click Manage Groups
Click + New Group
Enter a name (e.g., "Technical Bugs", "Process Issues")
Click Create
Assign to Group
When creating or editing an issue:
Select the Group dropdown
Choose a group
The issue appears under that group
Updating Issues
Open the issue
Edit any field
Changes save automatically
Status changes are logged for audit purposes.
Issue Heatmap
View issue activity over time:
Open a project
View the issue heatmap
See patterns of issue creation and resolution
Identify problem periods
Best Practices
Writing Good Issue Titles
Be general
Example: "Authentication & SSO"
