> For the complete documentation index, see [llms.txt](https://docs.testfirst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testfirst.com/manual-testing-app/import-test-cases.md).

# Import Test Cases

{% hint style="info" icon="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**.
   {% endhint %}

### 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

{% hint style="success" icon="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
  {% endhint %}

{% stepper %}
{% step %}

### 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.
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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**
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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
  {% endstep %}
  {% endstepper %}

### 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.

{% hint style="info" %}

### 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
  {% endhint %}