> ## Documentation Index
> Fetch the complete documentation index at: https://guide.daro.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Migration Guide

> Follow the steps and checks for moving from the legacy SDK (before 2.0.0) to DARO 2.0 SDK.

See the [DARO 2.0 SDK overview](/en/new-daro-sdk/overview) for the six improvements in performance, revenue optimization, ad demand, size, security, and stability.

If you are on the legacy SDK (before 2.0.0), follow this order: **update the dashboard → get your Integration Key → update the SDK**.

## Before you start

Select **Start update** in the [DARO dashboard](https://dashboard.daro.so) and complete the dashboard update first. Check the Integration Key for each app and the Ad Unit Keys for the Ad Units you use. If your app supports both Android and iOS, get a separate key for each platform.

Updating the dashboard leaves the SDK in your published app unchanged. Build and release an app containing the DARO 2.0 SDK to complete the transition.

## Ad Unit compatibility

| SDK | Existing Ad Units | New Ad Units |
| - | - | - |
| legacy SDK (before 2.0.0) | <span className="font-semibold text-green-700 dark:text-green-400"><span aria-hidden="true">✓</span> Supported</span> | <span className="font-semibold text-red-700 dark:text-red-400"><span aria-hidden="true">×</span> Not supported</span> |
| DARO 2.0 SDK | <span className="font-semibold text-green-700 dark:text-green-400"><span aria-hidden="true">✓</span> Supported</span> | <span className="font-semibold text-green-700 dark:text-green-400"><span aria-hidden="true">✓</span> Supported</span> |

You can keep existing Ad Units without issuing new IDs. You must still apply SDK configuration and API changes. See the [support plan](/en/new-daro-sdk/legacy-support) for the legacy SDK (before 2.0.0) support period.

## Migration steps

<Steps>
  <Step title="Update the dashboard">
    Complete the dashboard update and check the apps and Ad Units you will migrate.
  </Step>

  <Step title="Remove legacy key files and settings">
    Remove `daro-key.txt` or `android-daro-key.txt` on Android, `ios-daro-key.txt` on iOS, and the old integration settings that use them. Follow your platform's guide for the specific items to remove.
  </Step>

  <Step title="Configure DARO integration tools">
    Install and apply the DARO plugin or integration tools listed in your platform's guide. Update any existing plugin configuration for the DARO 2.0 SDK.
  </Step>

  <Step title="Configure the Integration Key and app settings">
    Add the Integration Key from the dashboard to your project. Android and iOS use different configuration locations, so follow the example for your platform.
  </Step>

  <Step title="Update app-ads.txt">
    Add the latest app-ads.txt entries provided through the dashboard to your developer website. See the [app-ads.txt setup guide](/en/app-ads-txt-settings) for publishing and verification steps.
  </Step>

  <Step title="Update the SDK and release your app">
    Follow your platform's guide below to update the SDK and review initialization and the ad formats you use. Verify ad loading, display, and callbacks before releasing your app.
  </Step>
</Steps>

## Platform guides

| Platform | Update steps |
| - | - |
| Android | [Android migration guide](/en/sdk-integration-v2/android/migration-guide) |
| iOS | [iOS migration](/en/sdk-integration-v2/ios_new/migration-guide) |
| React Native | [React Native migration](/en/sdk-integration-v2/react-native/migration-guide) |
| Flutter | [Flutter migration](/en/sdk-integration-v2/flutter/migration-guide) |
| Unity | [Unity SDK installation and setup](/en/sdk-integration-v2/unity/get-started) |

## Before releasing

* Remove old key files and SDK settings, and register your Integration Key.
* Check that app-ads.txt contains the latest entries.
* Request ads only after SDK initialization completes.
* Verify loading, display, dismissal, and other required callbacks for the ad formats you use. Verify reward delivery for rewarded video ads.
* Test both existing Ad Units and any new Ad Units you added.

Contact [DARO support](mailto:cs@daro.so) if you need help with the transition.

## Refer to your previous integration

* Legacy SDK integration guides remain available during the legacy SDK support period. See the [legacy SDK support plan](/en/new-daro-sdk/legacy-support#support-schedule) for the schedule.
* Check your integration settings for the legacy SDK before 2.0.0 in the platform guides: [Android](/en/sdk-integration/android/get-started) · [iOS](/en/sdk-integration/ios_new/get-started) · [React Native](/en/sdk-integration/react-native/get-started) · [Flutter](/en/sdk-integration/flutter/get-started).