Whether you are migrating from a different test management tool or have many tests to add at once, import your tests from a CSV file to save time. You can upload up to 5,000 tests per file.
Import Tests
To import your tests, follow these steps:
In the Testlio platform, click Tests.
Click Import tests.
Optional: Select a separator character (the default is comma).
Select the file to import or drag it into the upload box.
When the file is verified, click Import.
You see a progress bar where you can cancel the import or follow how close it is to done.
If the system finds any issues with the CSV file, such as missing fields, too long content, or separator character issues, you are shown the issues and can't click Import.
Imported Fields
Mandatory fields are marked with *.
Field | Value | Description |
Test name* | Text up to 255 characters | A title for your test. |
Platforms | Comma-separated list of platform names | The platforms the test applies to, for example |
Labels | Comma-separated list of labels, each up to 255 characters | Any labels to add to the test. |
Features | Comma-separated list of features, each up to 255 characters | Any product features that your test describes. |
Priority |
| How important the test is. |
Automated on | Comma-separated list of platform names | The platforms the test has been automated on, for example |
Step type* | A step type. | How the step is presented to the tester and what is required as input. |
Step title* | Text | The actions that a tester must take to execute the step. |
Step details | Depends on step type | See step details. |
Execution time (minutes) | Number | The amount of time it takes to complete the test. |
Existing test ID - for test update | A unique ID (see updating) | The existing test to update. |
Test ID - for test / step update | A unique ID (see updating) | When updating a test, the same as When updating a test step, the ID of the test that holds the test step. |
Step ID - for step update | A unique ID (see updating) | The existing test step to update. |
Step Types
Type | Description |
| Step can be marked as |
| Tester selects one of the given options. |
| Tester selects a value on a numeric scale. |
| Tester submits a file. |
| Tester provides short text. |
| Tester can provide more text. |
| Guidelines for exploratory testing. |
| Information for the tester that doesn't require action. |
Step Details
Some types of steps require extra information. Each
Field | Value | Step Type | Description |
Step expected result | Test |
| The expected result when the tester executes the actions described in step description. |
Step options | Comma-separated list of options, each from 1 to 255 characters |
| The options presented to testers. |
Include other option |
|
| Whether "Other" is presented as the last option for testers to provide text input. |
Step scale start | Number from 1 to 10 |
| The start of the scale. |
Step scale start label | Text up to 255 characters |
| A label to display at the start of the scale. |
Step scale end | Number from 1 to 10 |
| The end of the scale. |
Step scale end label | Text up to 255 characters |
| A label to display at the end of the scale. |
Instructions | Text |
| Instructions to testers for exploratory testing. |
Focus Areas | Text |
| What to focus on for exploratory testing. |
Out of scope areas | Text |
| What not to focus on for exploratory testing. |
Update Tests
You can update existing tests via import. During update, a label is added to all updated tests to find them later. Metadata (such as labels and features) in the file overwrites any existing data in the Testlio platform.
Test steps are also overwritten if included.
If the CSV file contains an existing test and no steps, only data on the test is overwritten and the test steps remain.
If the CSV file contains an existing test and steps, any steps with matching IDs are overwritten and any steps with no matching IDs are created as new. Existing steps that do not match any steps in the file are not changed.
You can only update tests within a given workspace. Tests exported from workspace A cannot include IDs to be imported into workspace B.
To update existing tests or test steps, follow these steps:
In the Testlio platform, click Tests.
Select the tests you want to update.
Make sure the option to include references is selected.
Click Start Export.
When it's ready, download the CSV file.
Make all desired changes to the file.
By including references, the CSV file you download already has all of the unique IDs necessary for updates on import.