Skip to main content

Test Cases

A test case is the building block of Test Management. It describes one thing to verify: the action to take, the conditions it requires, and the result you expect. Every test case belongs to a Test Project and optionally to a Test Suite within that project.

Test case fields

FieldRequiredDescription
TitleYesShort, action-oriented description. E.g. “User can log in with valid credentials”
TypeYesMANUAL, AUTOMATED, or EXPLORATORY
StatusDRAFT (default) or READY. Only READY cases are enrolled in runs.
PriorityYesLOW, MEDIUM, HIGH, or CRITICAL
DescriptionNoRich-text body — use it for preconditions, steps, and expected results
SuiteNoThe test suite this case belongs to
Automated referenceNoLink to a test file, CI job, or external reference for AUTOMATED type cases

Writing good test cases

Structure your description with three sections:
**Preconditions**
- Logged in as a standard user
- Cart contains at least one item

**Steps**
1. Click "Checkout"
2. Fill in shipping address
3. Click "Place Order"

**Expected result**
Order confirmation page appears with correct order number.

Status lifecycle

DRAFT → READY → DEPRECATED
  • DRAFT — the case is still being written or reviewed. Excluded from runs.
  • READY — reviewed and approved. Included in the next run automatically.
  • DEPRECATED — retired case. Excluded from runs but preserved for history.
Only a Member or Owner can mark a case READY. This acts as a lightweight review gate.

Creating test cases

1

Open the test project

Navigate to the Space → Test Management → select the project.
2

Click New Case

Click + New Case in the top bar or press C with the case list focused.
3

Fill in the fields

Title and Type are required. Add description using the structured format above.
4

Mark READY when reviewed

Once the case has been reviewed, change status to READY to include it in future runs.

Cloning cases

Duplicate an existing case to create a variation: right-click the case in the list → Clone. The clone is created as DRAFT so it can be reviewed before being activated.

Importing cases

Bulk-import test cases from CSV: Project → Settings → Import → Upload CSV. Required columns: title, type, priority. Optional: description, suite.