Issues
Triage, categorize, and track problems found by Canary.
Issues are problems discovered by Cofactor during automated testing. Each issue represents a potential bug, broken functionality, or user experience problem found on your web application.
01How issues are created
You don't file issues by hand — Cofactor creates them automatically when a run detects a real defect. During a test run, each failure is analyzed to decide whether it's a genuine bug or test instability; genuine bugs become issues. Ad-hoc tests file issues for the problems they verify.
Issues are deduplicated: the same problem seen across multiple runs updates one issue instead of creating duplicates. Each detection is recorded as an occurrence, so an issue tracks when it was first and last seen and how many times it has recurred — useful for telling a one-off from a persistent regression.
02Issue Lifecycle
Issues follow a simple workflow:
- Open - Newly discovered issue awaiting review
- Fixed - The issue has been addressed in your application
- Verified - Cofactor has confirmed the fix works
- Closed - Marked as not-a-bug or won't fix
When you resolve an issue by moving it to Fixed, Verified, or Closed, Cofactor automatically removes any related follow-up task. This keeps follow-up work aligned with the issue status and prevents stale outstanding tasks from lingering after the issue is no longer active.
You can also archive issues to remove them from the default view without deleting them.
03Severity Levels
Issues are automatically assigned a severity based on their impact:
| Severity | Description |
|---|---|
| High | Major functionality broken, blocking user workflows, or a security/data risk |
| Medium | Partial functionality issues with a workaround available |
| Low | Minor or cosmetic issues and edge cases |
| Unknown | Severity not yet classified |
04Issue Categories (Labels)
Admins can create custom categories to organize issues by team, feature area, or type. Categories help route issues to the right people and track patterns.
To manage categories, go to Settings > Issue Labels.
05Evidence & Reproduction
Each issue includes evidence to help you understand and reproduce it:
- Screenshots - Visual capture of the full visible UI state at the moment feedback or a failure was captured, including overlays such as modals and drawers when they were on screen
- Browser traces - Network requests, console logs, and timing data
- Steps to reproduce - The exact actions that triggered the issue
- Environment details - Browser, viewport, and test configuration
Review the evidence first. Check the screenshot to confirm the exact screen state Cofactor captured, including any open modal, drawer, or other overlay that may have affected the user's path when the issue was reported.
Then use the linked follow-up task to capture ownership, track investigation, and document what happens next. This helps you keep reproduction details and investigation work connected in the same workflow.
06Reviewing issue details
Open an issue to review its evidence, reproduction steps, and linked pages in one place. Use the captured URL as a starting point, then compare it with the screenshot and steps to understand the exact app state Cofactor recorded.
If the captured issue URL is relative, open the linked page directly from the issue detail view. Cofactor resolves relative links correctly, so the page still opens in the right place without requiring you to rebuild the full URL yourself.
When you navigate from the issue to the linked page, use the issue evidence to confirm you are back in the same flow. Check the screenshot, visible overlays, and reproduction steps before you continue investigating.
07Comments
Use comments to capture investigation details, ask questions, and coordinate next steps directly on the issue.
Write comments in the richer editor so you can draft longer updates more comfortably and format your notes before posting.
Type @ in a comment to mention a teammate. Cofactor suggests matching members as you type, highlights mentions clearly in the thread, and sends an email notification to each mentioned teammate.
Use mentions when you need input from a specific teammate, want to pull an owner into triage, or need to flag a follow-up directly from the issue discussion.
08Filtering Issues
Use the filters at the top of the issues page to narrow down:
- Severity - Filter by high, medium, low, or unknown
- Status - Show open, fixed, verified, or all issues
- Property - Filter by which property (website) the issue was found on
- Category - Filter by custom labels
- Credential - Filter by which login context was used
- Date range - Filter by when the issue was last seen
- Search - Full-text search across issue titles and descriptions
09Navigating from issues
Use links in the issues list or issue detail view to open the affected page quickly. Open the linked page when you want to verify the current app state, compare it with the recorded evidence, or continue investigation from the exact location Cofactor captured.
If the issue shows a relative URL, use the link as-is. Cofactor resolves relative links correctly from both the issues list and the issue detail view, so the destination page can still open correctly even when the captured URL is not a full absolute address.
After the linked page opens, use your browser back button or return to the issue to keep triage moving. This helps reduce confusion when you move between the source page and the issue evidence during investigation.
10Bulk Actions
Select multiple issues to perform bulk actions:
- Archive - Remove from default view
- Export - Download as CSV for reporting
11Jira Integration
If you've connected Jira, you can create tickets directly from issues. The Jira ticket will be linked to the Cofactor issue and kept in sync.
See Jira Integration for setup instructions.
12Collaboration and triage
Use issue comments and follow-up tasks together to keep triage decisions visible in one place. Review the evidence, leave context in the thread, and mention the teammates who need to weigh in before you move work forward.
13Best Practices
- Triage regularly - Review new issues daily to catch problems early while context is fresh
- Use follow-up tasks for investigation - Move from the issue into the linked task to assign work, track investigation, and keep next steps visible
- Use categories - Organize issues by team or feature for better routing
- Verify fixes - Run tests after deploying fixes to confirm resolution
- Archive, don't delete - Keep a record of past issues for trend analysis