# How to migrate

<figure><img src="https://2908774936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHREX7DHcljbY5IkjgJ-1972196547%2Fuploads%2FmCNKTtGrKgKdvQXfe8Wv%2Fimage.png?alt=media&#x26;token=ca42bfe5-ee31-4388-8f24-0cee7d29af14" alt=""><figcaption></figcaption></figure>

In April 2023, PancakeSwap announced V3 for Exchange and Farms. Some farming pairs will need to be migrated to keep earning staking rewards. Relax, like last time, it should be smooth.

### But wait! Do I need to migrate? <a href="#id-4b9e0260-9dee-493b-b0ad-6bdba084cea6" id="id-4b9e0260-9dee-493b-b0ad-6bdba084cea6"></a>

You need to migrate if you meet the following conditions:

**Farming on the following V2 PancakeSwap Farms:**

* BNB Chain:
  * CAKE-BNB
  * CAKE-BUSD
  * CAKE-USDT
  * BUSD-BNB
  * USDT-BNB
  * BTCB-BUSD
  * BTCB-USDT
  * BTCB-ETH
  * BTCB-BNB
  * ETH-BNB
  * ETH-USDC
  * USDC-USDT
  * BUSD-USDC
  * BUSD-USDT
* Ethereum:
  * ETH-USDC
  * ETH-USDT
  * WBTC-ETH

The list will likely grow eventually. The easiest way to check the updated list is to visit <https://pancakeswap.finance/migration> and connect your wallet

**Providing V2 liquidity, and meeting the following conditions:**

* The majority of the liquidity for the token pair has been migrated to V3 - Please check the PancakeSwap Info page, or the website or social channels of the token project for more detail.
* The project team of that token has announced the liquidity will be migrated to V3 - Please check the individual project websites or social channels for more detail.

### How to migrate <a href="#c7d7b407-268c-460c-a4f1-be1b771db5e7" id="c7d7b407-268c-460c-a4f1-be1b771db5e7"></a>

<figure><img src="https://2908774936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHREX7DHcljbY5IkjgJ-1972196547%2Fuploads%2FOWpVoVJW0YRy5ASWHsJH%2Fimage.png?alt=media&#x26;token=06b2c9ed-6681-47b0-b4bd-01627165ec06" alt=""><figcaption></figcaption></figure>

Look for the V3 migration banner on the Liquidity or Farm page. Then click “Proceed” to enter the migration helper page.

**Step 1 - Unstake from V2 and/or StableSwap farms**

<figure><img src="https://2908774936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHREX7DHcljbY5IkjgJ-1972196547%2Fuploads%2FnStLXuOX93ekZYMtXGJR%2Fimage.png?alt=media&#x26;token=7ba8dc25-4f18-4628-ba03-b2830137a2c2" alt=""><figcaption></figcaption></figure>

In step 1, the helper will list all the PancakeSwap V2 or StableSwap farms that require migrations.

Click each of the “Unstake All” buttons to unstake all staked LP tokens from farms. Your wallet will ask for confirmation.

When all the listed farms are unstaked, click “Next Steps” to proceed.

**Step 2 - Remove liquidity from Exchange V2 or StableSwap**

<figure><img src="https://2908774936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHREX7DHcljbY5IkjgJ-1972196547%2Fuploads%2FMU9nGLqwLh5YBpb8GGXn%2Fimage.png?alt=media&#x26;token=ca6b9cfc-104c-496e-bd3d-f2ce8344c315" alt=""><figcaption></figcaption></figure>

In step 2, the helper will list all the liquidity positions that can be migrated to V3 with CAKE yield farming.

Click each of the "Remove" buttons to bring up the remove liquidity modal with 100% selected.&#x20;

Then click “Enable”, sign the transaction in your wallet, and click “Remove”. Your wallet will ask for confirmation.

{% hint style="info" %}
Even though some other project tokens are also migrating to V3, they will not appear in the list. Please check the individual project websites or social channels for more detail. And use the [Liquidity](https://pancakeswap.finance/liquidity) page to migrate manually.
{% endhint %}

**Step 3 - Get ready for V3**

<figure><img src="https://2908774936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHREX7DHcljbY5IkjgJ-1972196547%2Fuploads%2FJ8g4PYIN9Q1KxUuB9GsH%2Fimage.png?alt=media&#x26;token=633530e0-aadc-4e71-9d15-661b16296a57" alt=""><figcaption></figcaption></figure>

No action is needed. Simply read and make sure you are familiar with how V3 works and how to provide liquidity in V3.

**Step 4 - Add V3 liquidity**

![](https://2908774936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHREX7DHcljbY5IkjgJ-1972196547%2Fuploads%2FQiunEZMugKE1VWpEHEFZ%2Fimage.png?alt=media\&token=137300f8-ce03-4d62-8285-427c43b0f3aa)

In this step, you will add your liquidity to the new Exchange V3.

Click “Add Liquidity”. Your previously removed V2 liquidity will show up in the list, click “Add” to bring up the interface for adding V3 liquidity.

If you don’t see the pair you want to add, click “Add Other Pairs” instead and choose the two tokens manually.

For a more detailed tutorial on how to provide liquidity in V3, read [here](https://docs.pancakeswap.finance/~/revisions/4JQRJCuMPHEJgYdxdVME/earn/pancakeswap-pools/liquidity-guide).

If you have questions while providing liquidity in V3, check here for [FAQ](https://docs.pancakeswap.finance/~/revisions/4JQRJCuMPHEJgYdxdVME/trade/trading-faq/swap-faq).

{% hint style="warning" %}
Please be aware that in Exchange V3, only active (in-range) liquidity positions will earn trading fee rewards.

Please be cautious while setting the price range for the liquidity position.
{% endhint %}

**Step 5 - Stake in V3 farms**

<figure><img src="https://2908774936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHREX7DHcljbY5IkjgJ-1972196547%2Fuploads%2F2nZNL9Jv6ajexLuQaidz%2Fimage.png?alt=media&#x26;token=2261286b-7367-4de2-bcbe-43c4ef11cd38" alt=""><figcaption></figcaption></figure>

In this step, you will stake your freshly added V3 liquidity positions to the new V3 farms to start earning CAKE rewards!

Click each of the “Stake” buttons on the position to stake them into farms. Your wallet will ask for confirmation.

For a more detailed tutorial on how to farm in V3, read [here](https://docs.pancakeswap.finance/~/revisions/4JQRJCuMPHEJgYdxdVME/earn/yield-farming/how-to-use-farms#farm-v3).

If you have questions while staking liquidity in V3 farms, check here for [FAQ](https://docs.pancakeswap.finance/~/revisions/4JQRJCuMPHEJgYdxdVME/earn/earn-faq/farming-faq).

{% hint style="warning" %}
Please be aware that in Farm V3, only active (in-range) liquidity positions will earn CAKE rewards.

Please be cautious while setting the price range for the liquidity position.
{% endhint %}

**Finished**

That's it. You've migrated your farm staking and liquidity to the new PancakeSwap V3!
