> For the complete documentation index, see [llms.txt](https://help.branch.io/llms.txt).

# Add and Manage Test Devices (New)

> Add test devices in Branch to easily test your campaign setup in the Test Devices tab.

## Overview

To easily test your campaign setup, we recommend you first add a test device to your Branch account. Doing so tells Branch servers that resulting conversions from said device are for testing purposes only; i.e. these conversions won't be considered normal traffic and therefore not be treated as such.

As Branch only allows one install event per unique device to ever be measured and stored, if you don't first add a test device, you'll only be able to test the install conversion event once ever.

> **Attention**
>
> Branch's new experience is rolling out in phases, so your interface may differ. This article covers the Testing & Monitoring page in the new experience. To learn more, see [New Branch Overview](https://help.branch.io/account-hub/new-branch-overview.md).

## Supported device IDs

To identify your device as a test device within Branch, you need to provide one of the following device IDs:

- **Android**: Google Advertising ID (GAID)
- **iOS**: Identifier for Advertisers (IDFA)

**Use Branch's Device ID Finder App**

If you don't know how to access your device's IDs, you can use Branch's Device ID Finder app to easily see your device's ID.

- Get the [Android App](https://play.google.com/store/apps/details?id=io.branch.deviceid)
- Get the [iOS App](https://apps.apple.com/us/app/branch-device-id-finder/id1477763736)

> **Note**
>
> - You can add up to 50 test devices per app in Branch.
> - To add, refresh, or delete a test device, you need **Edit** access to **App-level Settings**. Users with **View** access can see the list of test devices.
> - The test device is specific to the app you add it under. If you use it to test other apps, Branch will treat it like live traffic and it will be attributed and used for downstream analytics.
> - These test devices will work in both the live and test environment. You only need to add it once.

To ensure you can use your device to test:

1. Under **Configuration**, select **Testing & Monitoring > Test Devices**.
2. Select **Add device**.
3. In the **Add test device** modal, provide the following:

   - **Device name:** Choose a name to help you recognize this device. Names can be up to 25 characters and use letters, numbers, spaces, and apostrophes.
   - **Platform:** Select the platform for your test device.
   - **Device ID:** Enter a Device ID in IDFA format for iOS or GAID format for Android. You can't add the same device ID twice.
4. Select **Add device**.

## Refresh your test device

If you need to test the install event more than once, you need to refresh your test device after each install attempt. Not doing so results in the next install attempt being marked as `reinstall`.

To refresh your test device:

1. On the **Test Devices** tab, find the test device you want to refresh and select the three-dot icon.
2. Select **Refresh device**.

## Delete a test device

To remove a test device from your account:

1. On the **Test Devices** tab, find the test device you want to delete and select the three-dot icon.
2. Select **Delete device**.
3. Select **Delete** to confirm.

You can't undo a deletion. To test with the device again, add it back.