Defects
Introduction
Section titled “Introduction”What is the Defects screen?
Section titled “What is the Defects screen?”The Defects screen is Testver’s integrated defect (bug) tracker. Whenever a test reveals that the product behaves differently from what was expected, you record that problem here as a defect. Each defect captures what went wrong, how serious it is, who should fix it, and how far along the fix has progressed.
Think of it like a hospital intake-and-triage board. A patient (the bug) arrives, gets a severity assessment (how badly is it hurt?), a priority for treatment order, an assigned doctor (assignee), and then moves through wards — admitted, under treatment, recovered, discharged — until it either heals or is sent home as a false alarm. The Defects board lets you see every patient and which ward they are in at a glance.
Defects do not have to be created by hand. From the Results screen, when a test has failed you can open its detail panel and click Create Defect, and Testver pre-fills a new defect titled [FAIL] <test name> using the failure’s suite, file, browser, duration, retry count, error message, and failed-step details. That defect then appears on this Defects screen exactly like a manually created one, with its reporter set to the user who clicked the button (or Automation).
Who this guide is for
Section titled “Who this guide is for”- QA engineers and testers who find bugs during manual or automated test runs and need to log them with full reproduction detail.
- Developers who are assigned defects and need to read steps to reproduce, view attachments, change status as they work, and leave comments.
- Test leads and managers who triage incoming defects, set priority and severity, balance assignment across the team, and watch the Open / In Progress / Blockers / Overdue counters.
- Anyone bridging Testver and JIRA who needs a Testver defect mirrored into an external issue tracker.
Key terms
Section titled “Key terms”| Term | What it means in Testver |
|---|---|
| Defect | A single recorded bug or problem. Has a title, description, severity, priority, status, assignee, reporter, and optional attachments, links, and a linked test case. Shown on the board and list with an ID like DEF- followed by the first 7 characters of its internal id. |
| Severity | How damaging the bug is to the product, independent of scheduling. One of Blocker, Critical, Major, Minor, or Trivial. |
| Priority | How urgently the bug should be worked, i.e. scheduling order. One of P1-Critical, P2-High, P3-Medium, or P4-Low (stored as p1–p4). New defects default to P3-Medium. |
| Status | Where the defect sits in its lifecycle: Open, In Progress, Resolved, Closed, or Rejected. Drives the board columns and the workflow bar. |
| Status workflow | The expected forward path Open → In Progress → Resolved → Closed, with Rejected as a separate side exit for invalid / won’t-fix defects. |
| Assignee | The person responsible for fixing the defect (the Assigned To field). Shown on cards and rows; blank shows as Unassigned. |
| Reporter | The person who raised the defect. Defaults to the current logged-in user’s display name when you open the create form. |
| Blocker | A severity level (the most severe) and also a top-row counter showing how many blocker-severity defects are still active (not closed or rejected). |
| Overdue | A defect whose Due Date is in the past while it is still not Closed or Rejected. Highlighted in amber and counted in the top stats row. |
| Age | How many days old the defect is, computed from its creation date — e.g. 5d. |
How it works
Section titled “How it works”- Results → Defects: A failed test in the Results screen can be turned into a defect with one click. Testver copies the failure context (error message, failed steps, environment-style metadata) into the new defect so you do not retype it.
- Test Cases → Defects: A defect can be linked to a specific test case via the Linked Test Case field, giving traceability from “this manual test” to “the bug it exposed.” The linked id (and title, when known) appears in the defect’s detail panel.
- Defects → JIRA: A defect can be pushed outward to JIRA as an issue, after which its external key and live JIRA status are shown alongside the Testver status.
Getting Started
Section titled “Getting Started”Opening Defects
Section titled “Opening Defects”- From the Testver navigation, open the route
/defects(the Defects entry). - The screen loads with the stats row at the top, a filter/toolbar row, and the defect board or list below.
- While defects load you will briefly see Loading defects… with a spinner.
- If there are no defects yet (or none match your filters), you’ll see an empty state reading No defects found with the hint “Create a defect or adjust your filters.”
The screen layout
Section titled “The screen layout”| Area | Location | What it does |
|---|---|---|
| Stats row | Top, five cards | Total Defects, Open, In Progress, Blockers, Overdue counters. |
| Search box | Toolbar, left | Free-text search across defects (Search defects…). |
| Status filter | Toolbar | Dropdown to filter by a single status (All Statuses by default). |
| Severity filter | Toolbar | Dropdown to filter by a single severity (All Severities by default). |
| View toggle | Toolbar | Switch between Board (Kanban) and List (table) views. |
| Export button | Toolbar, right | Exports a defect report as docx, xlsx, or csv. |
| New Defect | Toolbar, far right | Opens the create-defect modal. |
| Board / List body | Center | The defects themselves, either as Kanban columns or as a table. |
| Detail panel | Slides in from right | Opens when you click a defect; shows full info, activity, and comments. |
| Create / Edit modal | Centered overlay | Full form for creating or editing a defect. |
| Success toast | Top-right, transient | Green confirmation after save/transition/delete; auto-dismisses after ~3 seconds. |
At a glance
Section titled “At a glance”| Card | Counts |
|---|---|
| Total Defects | Every defect currently matching your filters (or the total from server stats). |
| Open | Defects with status Open. |
| In Progress | Defects with status In Progress. |
| Blockers | Blocker-severity defects that are still active (not Closed and not Rejected). |
| Overdue | Defects past their Due Date that are still active (not Closed and not Rejected). |
The Defects List
Section titled “The Defects List”List view
Section titled “List view”Switch to List view using the toggle. Each row is clickable and opens the detail panel; the Actions cell is excluded from that click.
| Column | Shows |
|---|---|
| ID | DEF- followed by the first 7 characters of the defect’s id, in monospace. |
| Title | The defect title. |
| Priority | A colored pill: P1-Critical, P2-High, P3-Medium, or P4-Low. |
| Severity | A colored pill: Blocker, Critical, Major, Minor, or Trivial. |
| Status | A colored status pill, plus a live JIRA: <status> badge if the defect has a JIRA key and JIRA is connected. |
| Assignee | The assigned person (with a user icon), or — if unassigned. |
| Due Date | The due date; rendered in amber when the defect is overdue, otherwise —. |
| Age | Days since creation, e.g. 5d. |
| Actions | Edit (pencil) and Delete (trash) icons. |
Board view
Section titled “Board view”The default view is Board. Defects are grouped into five columns by status — Open, In Progress, Resolved, Closed, Rejected — each with a colored header, a count badge, and an empty-state message (“No defects”) when nothing is in that column.
- Each card shows the title, the external id or internal id (monospace, top-right), outlined priority and severity badges, an optional JIRA status badge, the assignee (or
Unassigned), and the defect’s age in days. - Clicking a card opens the detail panel.
- Columns scroll independently when they contain many cards.
Filters & search
Section titled “Filters & search”| Control | Behavior |
|---|---|
| Search defects… | Free-text search; the term is sent to the server as a filter. Clearing the box removes the filter. |
| Status dropdown | Filters to a single status (Open / In Progress / Resolved / Closed / Rejected). “All Statuses” clears it. |
| Severity dropdown | Filters to a single severity (Blocker / Critical / Major / Minor / Trivial). “All Severities” clears it. |
Status colors & meaning
Section titled “Status colors & meaning”| Status | Color cue | Meaning |
|---|---|---|
| Open | Red | Newly logged, not yet being worked. |
| In Progress | Blue | Someone is actively fixing it. |
| Resolved | Emerald / green | A fix has been made and is awaiting verification. |
| Closed | Gray | Verified and finished. |
| Rejected | Slate | Invalid, duplicate, or won’t-fix — closed without a fix. |
Creating & Editing a Defect
Section titled “Creating & Editing a Defect”Click New Defect to open the create modal, or the Edit (pencil) icon on a row, card action, or the detail panel header to edit. The form is the same in both cases; the header reads New Defect or Edit Defect accordingly.
The defect form fields
Section titled “The defect form fields”| Field | Type | Notes |
|---|---|---|
| Title * | Text | Required. The Create / Update button stays disabled until a non-empty title is entered. |
| Description | Multi-line text | Free-form summary of the defect. |
| Priority | Dropdown | P1-Critical / P2-High / P3-Medium / P4-Low. Defaults to P3-Medium. |
| Severity | Dropdown | Blocker / Critical / Major / Minor / Trivial. Defaults to Major. |
| Status | Dropdown | Open / In Progress / Resolved / Closed / Rejected. Defaults to Open. |
| Expected Result | Multi-line text | What should have happened (“What should happen…”). |
| Actual Result | Multi-line text | What actually happened (“What actually happens…”). |
| Steps to Reproduce | Rich-text editor | A full formatting toolbar (headings, bold/italic/underline/strike, ordered & bullet lists, code block, blockquote, link, image). Falls back to a plain text area while the editor loads. |
| Environment | Text | Where it occurred, e.g. Chrome 120, Windows 11. |
| Assigned To | Searchable user picker | Type to search team members by display name, username, or email, or type a free-form name. |
| Reporter | Text | Pre-filled with the current user’s display name; editable. |
| Due Date | Date picker | Optional target date. A past date while still active marks the defect overdue. |
| Tags | Text | Comma-separated tags; shown as individual chips in the detail panel. |
| Linked Test Case | Searchable picker | Pick a test case to link (search by title or id), or choose None. |
| External ID | Text | An external tracker key, e.g. JIRA-1234. Drives the JIRA status badge when it matches a JIRA key pattern. |
| External URL | Text | Link to the external issue, e.g. https://… |
| Attachments | File upload | Upload screenshots, documents, or files — max 10MB each. Accepts images, .pdf, .doc, .docx, .txt, .log, .har, .json, .xml, .csv. Each upload shows a thumbnail (for images) or a file icon, name, and size, with a remove (×) button. |
| Reference Links | Title + URL list | Add named links (title optional — defaults to the URL). Press Enter in the URL box or click Add; each is listed with a remove button. |
Click Create (new) or Update (edit) to save; Cancel or the × closes the modal without saving. A green toast confirms “Defect created successfully” or “Defect updated successfully.”
The status workflow
Section titled “The status workflow”Open a defect to reveal the status workflow bar in the detail panel header. It shows the forward path as clickable steps with arrows between them, plus a separate Rejected button on the right.
- The forward steps are Open → In Progress → Resolved → Closed.
- The current status is highlighted; earlier (past) steps are shown in a muted brand color.
- Click any step other than the current one to transition the defect directly to that status — you are not forced to move one step at a time.
- Click Rejected to mark the defect invalid / won’t-fix; this is a side exit outside the main forward path.
- Each transition records who performed it and shows a toast like “Defect transitioned to In Progress.”
| From | Typical next step | Why |
|---|---|---|
| Open | In Progress | Work has begun on the fix. |
| In Progress | Resolved | A fix is in place and ready for verification. |
| Resolved | Closed | The fix was verified. |
| Any active state | Rejected | The defect is invalid, a duplicate, or won’t be fixed. |
| Resolved / Closed | Open or In Progress | Reopen if the fix failed verification (transitions are not one-directional). |
The detail panel
Section titled “The detail panel”Clicking any defect slides out a detail panel from the right. It has a header (ID, priority, severity, title), the status workflow bar, an info grid, and three tabs.
- Info grid: Reporter, Assignee, Priority, Severity, Environment, Due Date, Created, Updated, Age, Resolution Time (hours from creation to resolution, when resolved), and an External Link row (or a Push to JIRA action when no external link exists yet).
- Details tab: Description, Expected Result, Actual Result, Steps to Reproduce (rendered rich text), Linked Test Case, Tags, Attachments (with View for images and Download), and Reference Links. Images can be opened full-size in a preview overlay with a Download button.
- Activity tab: A chronological timeline of events — created, status changes (showing old → new value), comments added, comments deleted, and field updates — each with who did it and when.
- Comments tab: A threaded list of comments (author, timestamp, text), each deletable. Add a comment in the box at the bottom and click Send, or press Ctrl+Enter. The header also offers Edit (pencil), Delete (trash), and Close (×). Deleting a defect — from the panel, a row, or a card — asks for confirmation first (“This action cannot be undone”).
Integrations
Section titled “Integrations”When a JIRA connector is configured, the Defects screen integrates with JIRA in two ways: showing live JIRA status on Testver defects, and pushing Testver defects out as new JIRA issues.
Live JIRA status
Section titled “Live JIRA status”If a defect’s External ID looks like a JIRA key (for example PROJ-123) and a JIRA connector is connected, Testver fetches and displays that issue’s current JIRA status as a small JIRA: <status> badge. The badge appears on list rows, board cards, and the detail panel’s External Link row, color-coded by JIRA status category (To Do / In Progress / Done).
Push to JIRA
Section titled “Push to JIRA”In a defect’s detail panel, when the defect has no external link yet and JIRA is configured, a Push to JIRA button appears. Use it to create a matching JIRA issue from the defect.
- Open the defect and click Push to JIRA.
- Choose a Project from the dropdown of available JIRA projects.
- Choose an Issue Type (defaults to Bug; the list is filtered to Bug/Task/Story/Sub-task/Defect-like types).
- Review the “Will create: <title>” summary, then click Create in JIRA.
- On success, Testver writes the new JIRA key into the defect’s External ID and the issue URL into External URL, after which the live JIRA badge takes over.
| Testver field | Mapped into the JIRA issue |
|---|---|
| Title | JIRA summary. |
| Description, Steps, Expected, Actual, Environment | Combined into the JIRA description (HTML stripped from steps). |
| Priority (p1–p4) | Mapped to Highest / High / Medium / Low. |
| Severity | Added as a JIRA label, alongside a testver label. |
| Defect id | Recorded in the description as the source reference. |
Common Tasks (How Do I…?)
Section titled “Common Tasks (How Do I…?)”| I want to… | Do this |
|---|---|
| Log a brand-new bug | Click New Defect, fill in at least a Title, set severity/priority, then Create. |
| Log a bug from a failed test | Go to Results, open the failed test’s panel, and click Create Defect — it pre-fills from the failure. |
| Find a specific defect | Type into Search defects… or use the Status / Severity dropdowns. |
| See defects grouped by stage | Use the Board view toggle (Kanban columns by status). |
| See defects as a sortable table | Use the List view toggle. |
| Move a defect forward | Open it and click the next step (e.g. In Progress) in the status workflow bar. |
| Reject an invalid bug | Open it and click the Rejected button in the workflow bar. |
| Assign a defect to someone | Edit it and pick a person in Assigned To (searchable by name/username/email). |
| Attach a screenshot or log | Edit the defect and use Attachments (max 10MB per file). |
| Link a defect to a test case | Edit it and choose a case in Linked Test Case. |
| Discuss a defect with the team | Open it, go to the Comments tab, type, and Send (or Ctrl+Enter). |
| See the full history of a defect | Open it and view the Activity tab. |
| Mirror a defect into JIRA | Open it and click Push to JIRA (requires a JIRA connector). |
| Export the defect list | Click Export and choose docx, xlsx, or csv. |
| Delete a defect | Click the trash icon on the row, card-area, or detail panel and confirm. |
Tips & Best Practices
Section titled “Tips & Best Practices”- Separate severity from priority. Severity is how broken it is; priority is how soon to fix it. A Trivial typo on the home page can still be P1 if it embarrasses the brand.
- Write reproducible steps. Use the Steps to Reproduce rich-text editor with numbered steps and a code block for stack traces or commands — it renders cleanly in the detail panel.
- Attach evidence. A screenshot,
.har, or.logfile removes ambiguity. Keep each file under 10MB. - Fill the Due Date for anything time-sensitive so it surfaces in the Overdue counter and turns amber once it slips.
- Keep status honest. Move a defect to In Progress when you actually start, and to Resolved only when the fix is ready for verification — the Activity timeline is only as useful as the transitions you record.
- Link the test case so future testers can trace the bug back to the scenario that found it.
- Prefer creating defects from Results for automation failures — the auto-filled context is more accurate than retyping the error.
- Use Reject, not Delete, for false alarms when you want to keep a record; Delete is permanent.
Troubleshooting & FAQ
Section titled “Troubleshooting & FAQ”| Symptom | Likely cause / fix |
|---|---|
| Create / Update button is greyed out | The Title field is empty. A non-empty title is required to save. |
| My attachment didn’t appear | The file exceeded the 10MB per-file limit and was skipped. Compress it or split it. |
| No defects show even though I created some | An active Status or Severity filter or a search term is excluding them. Reset to “All Statuses” / “All Severities” and clear the search box. |
| The board has no Drag-and-drop | That’s expected — change status from the workflow bar inside a defect, not by dragging cards. |
| I don’t see a JIRA badge or Push to JIRA button | No JIRA connector is configured, or the External ID isn’t a valid JIRA key. Configure the connector / set a key like PROJ-123. |
| JIRA push failed | An error is shown inline in the push form (e.g. permission or required-field issue in JIRA). The Testver defect is unchanged — fix the cause in JIRA and retry. |
| Blocker / Overdue counts look low | Closed and Rejected defects are intentionally excluded from those counters. |
| Reporter is blank on an auto-created defect | Defects auto-created from Results set the reporter to the user who clicked Create Defect, falling back to Automation if no user is known. |
| Resolution Time shows a dash | It only appears once the defect has been resolved; it is the hours between creation and resolution. |
| My comment didn’t send | An empty comment can’t be sent. Type text, then click Send or press Ctrl+Enter. |
Related
Section titled “Related”- Test Plans → Executions — file defects from failed steps.
- Results — file defects from automated failures.
- Test Cases — what defects link to.
- Connectors → JIRA — wire JIRA in.