Skip to main content

​
Writing Test Cases

A Test Case describes a specific scenario to be tested — what steps to take and what the expected outcome should be. This guide covers creating test cases manually and importing them in bulk via CSV.

​
Before you start

Test cases are organised within Modules. Before creating a test case, make sure you have:
  • A project created
  • At least one module set up within that project
Don’t have a module yet? See Modules & Tags to set one up first.

​
Creating a test case manually

​
1. Navigate to Test Cases

From the left sidebar, open your project and click Test Management. Select a module from the left panel, then click Add Test Case.

​
2. Fill in the test case details

​
Title
text
required
A clear, descriptive name for the test case. Must be at least 3 characters.
Example: “User can log in with valid credentials”
​
Test Step
text
required
The steps a tester should follow to execute this test. Write each step on a new line for clarity.Example:
1. Navigate to the login page
2. Enter a valid email address
3. Enter the correct password
4. Click the Login button
​
Expected Outcome
text
required
What should happen when the test steps are completed successfully.
Example: “User is redirected to the dashboard and sees a welcome message”
​
Priority
select
required
The priority level of this test case. Options are fetched from your project settings.
​
Status
select
required
Controls visibility of the test case.
  • Published — visible and available for test runs (default)
  • Draft — work in progress, not yet ready for execution
​
Tag
select
Optional. Categorise your test case with a tag (e.g. regression, smoke, api, ui). Tags help you filter and group test cases for specific test runs.
​
Comment
text
Optional. Add any additional notes or context for testers running this test case.
​
Attachments
file
Optional. Attach supporting images (JPG or PNG only). Maximum 2 files, up to 100MB each.

​
3. Save the test case

Click Create. You’ll be returned to the test cases list where your new test case will appear.

​
Importing test cases via CSV

If you have existing test cases in a spreadsheet, you can bulk import them using a CSV file.

​
1. Download the sample CSV

On the Test Cases page, click Import Via CSV, then click Download Sample CSV to get the template.

​
2. Prepare your CSV file

Your CSV must include the following columns:
ColumnRequiredMax LengthNotes
titleYes500 charsTest case name
teststepYes1000 charsSteps to execute
expected_outcomeYes500 charsExpected result
priorityYes50 charsMust match a priority in the system
commentNo—Additional notes
tagNo—Tag name
Column headers are case-insensitive but must match exactly. The file must be saved as UTF-8 encoded CSV.

​
3. Upload and import

Drag and drop your CSV file onto the upload area, or click to browse. TMS ONE will validate each row before importing. If any rows contain errors you’ll see a summary showing:
  • How many test cases were imported successfully
  • How many failed and why (with row numbers)
Fix any errors in your CSV and re-upload to complete the import.

​
Field reference

FieldRequiredDefaultNotes
TitleYes—Min 3 characters
Test StepYes—All steps in one field
Expected OutcomeYes—Cannot be blank
PriorityYes—Selected from dropdown
StatusYesPublishedPublished or Draft
TagNo—Optional categorisation
CommentNo—Additional notes
AttachmentsNo—JPG/PNG, max 2 files, 100MB each

​
Tips for writing good test cases

Avoid vague instructions like “check the login”. Write exactly what the tester should do: which page to go to, what to enter, and what to click.
Each test case should test a single, specific scenario. Avoid combining multiple flows into one test case — it makes results harder to interpret.
If a test case isn’t ready yet, save it as Draft. It won’t appear in test runs until you publish it.
Agree on a tagging convention with your team (e.g. regression, smoke, api) so you can easily filter test cases when creating test runs.

​
What’s next?

Running Tests

Execute your test cases and track results

AI Test Generation

Let AI generate test cases from acceptance criteria