> ## Documentation Index
> Fetch the complete documentation index at: https://openmetadata-add-ontology-explorer-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Import Test Cases

> Learn to bulk import data quality test cases in OpenMetadata using CSV files, at the table, test suite, or platform-wide scope.

# Bulk Import Test Cases

Importing test cases from a CSV file lets you create or update several test cases at once, instead of adding them one at a time through the UI. You can import test cases for a single table, for a test suite, or across your entire platform.

For more information about what each column in the file means, see the [CSV Field Reference](/v2.0.x-SNAPSHOT/how-to-guides/data-quality-observability/quality/import-export-test-cases).

## Bulk Import Test Cases for a Table

To import test cases scoped to a single table:

1. In the left navigation menu, click **Explore**, and select the table whose test cases you want to import.
2. Navigate to the **Data Observability** tab.
3. In the **Data Quality** tab, click **Test Cases** if not selected.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/table-test-cases.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=cf70d447cc89a216d9c7e1da94e803a7" alt="Access Table Test Cases" width="2528" height="1390" data-path="public/images/how-to-guides/data-quality-observability/quality/table-test-cases.png" />
4. Click the **⋮** icon and click **Import**.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/select-import-table.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=deeda006ffb1076a0e2983de4142cf74" alt="Import test cases for a single table" width="2448" height="646" data-path="public/images/how-to-guides/data-quality-observability/quality/select-import-table.png" />
5. Upload or drop the CSV file.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/upload-test-cases.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=92a0cfbc97b070d4cb8e59deaaf994e6" alt="Upload the test case CSV file" width="2510" height="788" data-path="public/images/how-to-guides/data-quality-observability/quality/upload-test-cases.png" />
6. Preview the uploaded file and add or modify rows using the inline editor.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/preview-edit-import.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=ad5f1fec0b74667b5232f89403fe3a90" alt="Preview of the test case CSV file" width="2420" height="1476" data-path="public/images/how-to-guides/data-quality-observability/quality/preview-edit-import.png" />
7. Validate your changes. A green or red tick in the **Status** column displays the success or failure of the test cases.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/validate-import-test-cases.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=e3bf567780adf05cbc7bd364cda704ea" alt="Validate the test case CSV file" width="2460" height="678" data-path="public/images/how-to-guides/data-quality-observability/quality/validate-import-test-cases.png" />
8. Click **Update** to apply the changes.

## Bulk Import Test Cases in a Suite

To import test cases scoped to a single test suite:

1. Navigate to **Data Observability** > **Data Quality**.
2. Click the **Test Suites** tab and switch to **Bundle Suites**.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/test-suites-test-case.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=cc1f293dc86cf64c1adb9d1fc223c37f" alt="Select a bundle test suite" width="2996" height="1258" data-path="public/images/how-to-guides/data-quality-observability/quality/test-suites-test-case.png" />
3. Search and select the bundle suite whose test cases you want to import.
4. Click the **⋮** icon and click **Import**.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/select-import-suite.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=41661bdedd437b3bd9fc09bab4b7ff1a" alt="Import test cases for a test suite" width="2472" height="1066" data-path="public/images/how-to-guides/data-quality-observability/quality/select-import-suite.png" />
5. Repeat steps 5 to 8 from [Bulk Import Test Cases for a Table](#bulk-import-test-cases-for-a-table).

## Bulk Import All Test Cases

To import test cases across your entire OpenMetadata instance:

1. Navigate to **Data Observability** > **Data Quality**, and click **Test Cases**.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/test-cases-tab.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=b176c5c9370de80e9e18eb01091c30bd" alt="Test Cases Tab" width="2508" height="1284" data-path="public/images/how-to-guides/data-quality-observability/quality/test-cases-tab.png" />
2. Click the **⋮** icon and select **Import**.
   <img src="https://mintcdn.com/openmetadata-add-ontology-explorer-docs/J3z1dk87rUsak4VY/public/images/how-to-guides/data-quality-observability/quality/select-import-test-cases.png?fit=max&auto=format&n=J3z1dk87rUsak4VY&q=85&s=77ccef902a30a80e25ea6fbcc6381614" alt="Import test cases platform-wide" width="2534" height="1302" data-path="public/images/how-to-guides/data-quality-observability/quality/select-import-test-cases.png" />
3. Repeat steps 5 to 8 from [Bulk Import Test Cases for a Table](#bulk-import-test-cases-for-a-table).

## Import Using API

You can also import test cases using the API with the following endpoints:

`PUT /api/v1/dataQuality/testCases/name/{name}/import`

`PUT /api/v1/dataQuality/testCases/name/{name}/importAsync`

`{name}` only matters when `targetEntityType=testSuite`: set it to the Fully Qualified Name (FQN) of the test suite that newly created test cases should be added to. For any other `targetEntityType` (or when it's omitted), `{name}` isn't used — each row's `entityFQN` column determines which table or column the test case applies to. Both endpoints take the CSV file as the raw request body and support two query parameters:

* **dryRun**: `true` or `false` (default `true`). Validates the file without making changes, matching the preview step in the UI.
* **targetEntityType**: The entity type the test cases are being added to, for example `table` or `testSuite`.

The `importAsync` endpoint runs the import as a background job and is what the UI uses. The `import` endpoint returns the result synchronously.
