# Quick Import data using Zephyr Scale

Set up BrowserStack Test Management by quickly importing projects and test cases from Zephyr Scale.

- Due to limitations in the Zephyr Scale’s API, attachment migration is not supported during the quick import process.
- Do not change/modify the folder structure in Zephyr Scale while you import in Test Management.

## Prerequisites

- Before you start your import, ensure you have a Zephyr Scale user account that has full administrative privileges.

## Quick Import from Dashboard

You can do a Quick Import of Zephyr Scale by selecting the **Quick Import** option on top-right of the dashboard.

Also, you can do a **Quick Import** from Zephyr Scale once you have created a project in the dashboard.

On the **Quick Import** screen, select **Zephyr** and then select the **Zephyr Scale** type. You can then import Zephyr Scale data by entering API tokens and establishing a connection.

## Provide Zephyr Scale details and test connection

1. Enter **JIRA Host Name**. Host Name is your JIRA account, where Zephyr is linked. For example `https://abcd.atlassian.net`
2. Enter your **JIRA Email Address**.
3. Enter **JIRA API Token**. You can generate one from the [Atlassian API tokens page](https://id.atlassian.com/manage-profile/security/api-tokens).
4. Enter your **Zephyr Scale API Access Token**. To generate one, see the [SmartBear guide to generating API access tokens](https://support.smartbear.com/zephyr-scale-cloud/docs/rest-api/generating-api-access-tokens.html).
5. Click **Test Connection** to verify the connection with provided details.
6. Click **Proceed** to save and establish the connection.

## Confirm import

1. Select the Zephyr Scale projects that you want to import.
2. Click **Begin Import**.

## View and manage Import Logs

After confirming your import settings and initiating a Zephyr Scale import, you can track its progress and review the outcomes of current and all previous imports from the **Import Logs** tab. This centralized log helps you stay informed about ongoing imports and maintain a historical record of all completed or failed attempts, ensuring you have the details needed for troubleshooting and analysis.

### Key features of the Import Logs

- **Real-time status tracking**:

As soon as you start an import, it appears in the list with a corresponding status indicator. You can see whether the import is still in progress, has completed successfully, or encountered errors. The status icons and textual cues offer a quick snapshot of the current state.

- **Detailed metrics per Import**:

Each entry in the logs provides essential metrics about that specific import, such as:
   - Number of test cases imported: How many test cases were successfully brought over from Zephyr Scale.
   - Test runs & test plans data: The number of test runs and test plans associated with the import, allowing you to verify that key project elements have been accurately transferred.
   - Project count: The number of projects affected by the import operation.
- **User & timestamp information**:

The logs capture who initiated the import and when it was started. This helps maintain accountability and trace changes back to specific team members. If you have multiple team members initiating imports, this information streamlines coordination and follow-up.

- **Access to detailed error information**:
Using the action menu (the three dots next to a specific import), you can:
  - **View Report**: Dive deeper into the results of a completed or partially completed import. These reports can include success metrics, error messages, and other diagnostic details.
  - **Retry Import**: If an import encountered errors or did not yield the expected results, quickly reinitiate the process from here. This feature streamlines troubleshooting and reduces the time spent switching between different sections of the interface.

## Import progress

You can check the import progress on the **All Projects** page and click **View Details** to check import progress in the **Quick Import** detailed view.

If required, you can also **Cancel** the import process from the **Quick Import** detailed view.

After the import completes successfully, click **View Report** to check the result of the import process.

## Email notification

You will also receive an email notification at your registered email ID when the **Quick Import** process completes successfully.

Quick Import or CSV import saves email addresses of unregistered users and automatically assigns the associated test cases and test runs when they register or login to Test Management.

### Troubleshooting the Zephyr Scale Quick Import

Have you encountered an error, or is your import stuck? Find solutions to the most common problems in our [Zephyr Scale Quick Import troubleshooting documentation](/content/docs/test-management/troubleshooting/quick-import/zephyr-scale-issues/index.html).