Skip to main content

Creating and Managing Test Cases

Test cases are structured descriptions of how to verify that a feature or fix works correctly. Varai Sprints's built-in test management lets you create, organize, and track test cases alongside the tasks and issues they validate.


What is a test case?

A test case is a documented scenario that describes:

  • What to test (the feature or behavior being verified)
  • Preconditions (what needs to be set up before testing)
  • Steps (the exact actions to take)
  • Expected result (what should happen if everything works correctly)

Good test cases make testing repeatable — anyone on the team can run the same test and get consistent results.


Creating a test case

  1. In the left sidebar, click Test Cases.
  2. Click New Test Case.
  3. Fill in the form:
FieldRequired?Description
TitleYesA clear label for what is being tested (e.g., "User can reset password via email")
DescriptionNoOverview of what this test covers
PreconditionsNoWhat must be true before running this test
StepsYesNumbered steps to execute the test
Expected resultYesWhat should happen if the test passes
PriorityNoHow critical is this test?
StatusAutoDraft, Active, Deprecated
TagsNoLabels for organizing test cases
Linked issueNoLink this test case to the issue it validates
  1. Click Create Test Case.

Writing good test steps

Test steps should be specific and unambiguous. Each step should describe one action.

Example test case — Reset password:

Preconditions: User has an account with email test@example.com. User is not logged in.

Steps:

  1. Go to the sign-in page.
  2. Click "Forgot password?"
  3. Enter test@example.com in the email field.
  4. Click "Send reset link."
  5. Open the email inbox for test@example.com.
  6. Click the password reset link in the email.
  7. Enter a new password that meets requirements.
  8. Click "Reset password."

Expected result: User is redirected to the sign-in page with a success message: "Your password has been reset."


Test case statuses

StatusMeaning
DraftBeing written, not ready for execution
ActiveReady to run
DeprecatedNo longer relevant (feature changed or removed)

Running a test case

To record the result of running a test:

  1. Open the test case.
  2. Click Run Test.
  3. Select a result:
    • Pass — the test passed as expected
    • Fail — the test did not produce the expected result
    • Blocked — the test could not be run (e.g., a prerequisite was not ready)
    • Skip — test intentionally not run this cycle
  4. Add a note if needed (e.g., describe what failed).
  5. Click Save Result.

Each run is recorded in the test case's Run History — you can see who ran it, when, and what the result was.


Organizing test cases

Use Tags to organize test cases into logical groups:

  • By feature area: auth, payments, profile
  • By test type: smoke, regression, edge-case
  • By platform: mobile, desktop, api

Filter the test case list by tag to quickly find all tests for a specific area.