Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Import Test Cases

grid-2

Available only in the TestFirst Manual Testing App

You can download the TestFirst Manual Testing App from the Utilities Pack available in the TestFirst web application.

  1. Open the TestFirst web application.

  2. Scroll to the bottom of the left navigation panel.

  3. Click Utilities Pack and download the installer.

  4. Install and launch the TestFirst Manual Testing App.

Overview

TestFirst allows you to import test cases from a CSV file into the Test Case Library.

This is useful when:

  • Migrating test cases from another tool

  • Bulk creating manual test cases

  • Importing existing QA documentation

  • Setting up projects quickly

unlock

Permissions Required

To import test cases, users need:

  • Test Case → Create/Edit permission

Depending on the imported structure, additional permissions may also be required for:

  • Projects

  • Suites

  • Sections

  • Subsections

1

Start the Import Wizard

  1. Open the Manual Testing App

  2. Click Import Test Cases from the left navigation panel

The Import from CSV Wizard will open.

2

Download the Template

The wizard provides a downloadable CSV template.

The template includes:

  • Required columns

  • Supported fields

  • Formatting instructions

💡 Use the template to ensure the import file matches the expected structure.

3

Prepare the CSV File

Fill the template with your test case data.

The CSV file can contain:

  • Project

  • Suite

  • Section

  • Subsection

  • Title

  • Precondition

  • Status

  • Reference

  • Action

  • Expected results

⚠️ Maximum supported file size: 5 MB

4

Upload File & Configure Settings

Select the CSV file and configure import settings.

CSV Delimiter

Usually:

  • , (comma)

  • ; (semicolon)

Depends on your system regional settings.

File Encoding

Default:

  • Unicode (UTF-8)

Most editors support UTF-8 during save.

5

Map Columns

Map CSV columns to TestFirst fields.

The wizard automatically matches columns with similar names where possible.

You can also configure:

  • Dropdown value mappings

  • Custom system field mappings

Live Preview

Use Live Preview to verify how imported test cases will appear before import starts.

6

Review Import Summary

Before importing, TestFirst displays:

  • New project to be created

  • New suites/sections/subsections

  • Number of test cases

  • Validation issues or failures

You can also preview the resulting Test Case Library structure.

7

Start Import

Click Start Import to begin importing test cases.

During import:

  • Progress is displayed in real time

  • Failed records are identified

  • Error reasons are shown

Import Results

After completion, the wizard displays:

  • Successfully imported test cases

  • Failed imports

  • Failure reasons

  • Retry options for failed rows

You can also download an Import Report for reference.

Finish the Import

Click Finish to close the wizard.

Imported test cases will appear in the Test Case Library after refreshing the page in web app.

Notes

  • Close the CSV file before import to avoid file lock errors

  • Matching column names are mapped automatically

  • Validation issues are shown before import begins

PreviousExploratory Testing

Last updated