> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-metadata.org/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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/table-test-cases.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=9d626b5761716710258c8215b9311202" 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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/select-import-table.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=19bad4db4742ec7ab28bda92bdd79f39" 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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/upload-test-cases.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=65d93b8c4de63e128aca3036e89de704" 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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/preview-edit-import.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=48f0d272c523a3e4765373ff45072839" 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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/validate-import-test-cases.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=3d29b88ea5ec02753d175be3479de9b5" 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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/test-suites-test-case.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=12ec49ce1da63737a96530ef34874369" 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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/select-import-suite.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=edec4ba1145102a951e05c20ec313a75" 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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/test-cases-tab.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=4cd85231a5b767b433668f90fc9244e0" 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/0corNq5Y0FTYJtKO/public/images/how-to-guides/data-quality-observability/quality/select-import-test-cases.png?fit=max&auto=format&n=0corNq5Y0FTYJtKO&q=85&s=c8fb40bf9ae0c84f4d71b54f7d247b64" 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.
