How to migrate
Migrate your liquidity and farm stakings to the new PancakeSwap Exchange and Farm V3
![](https://docs.pancakeswap.finance/~gitbook/image?url=https%3A%2F%2F2908774936-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MHREX7DHcljbY5IkjgJ-1972196547%252Fuploads%252FmCNKTtGrKgKdvQXfe8Wv%252Fimage.png%3Falt%3Dmedia%26token%3Dca42bfe5-ee31-4388-8f24-0cee7d29af14&width=768&dpr=4&quality=100&sign=8da44bbf&sv=1)
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?
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
![](https://docs.pancakeswap.finance/~gitbook/image?url=https%3A%2F%2F2908774936-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MHREX7DHcljbY5IkjgJ-1972196547%252Fuploads%252FOWpVoVJW0YRy5ASWHsJH%252Fimage.png%3Falt%3Dmedia%26token%3D06b2c9ed-6681-47b0-b4bd-01627165ec06&width=768&dpr=4&quality=100&sign=6d85047&sv=1)
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
![](https://docs.pancakeswap.finance/~gitbook/image?url=https%3A%2F%2F2908774936-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MHREX7DHcljbY5IkjgJ-1972196547%252Fuploads%252FnStLXuOX93ekZYMtXGJR%252Fimage.png%3Falt%3Dmedia%26token%3D7ba8dc25-4f18-4628-ba03-b2830137a2c2&width=768&dpr=4&quality=100&sign=32a389a4&sv=1)
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
![](https://docs.pancakeswap.finance/~gitbook/image?url=https%3A%2F%2F2908774936-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MHREX7DHcljbY5IkjgJ-1972196547%252Fuploads%252FMU9nGLqwLh5YBpb8GGXn%252Fimage.png%3Falt%3Dmedia%26token%3Dca6b9cfc-104c-496e-bd3d-f2ce8344c315&width=768&dpr=4&quality=100&sign=937e3d66&sv=1)
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.
Then click “Enable”, sign the transaction in your wallet, and click “Remove”. Your wallet will ask for confirmation.
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 page to migrate manually.
Step 3 - Get ready for V3
![](https://docs.pancakeswap.finance/~gitbook/image?url=https%3A%2F%2F2908774936-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MHREX7DHcljbY5IkjgJ-1972196547%252Fuploads%252FJ8g4PYIN9Q1KxUuB9GsH%252Fimage.png%3Falt%3Dmedia%26token%3D633530e0-aadc-4e71-9d15-661b16296a57&width=768&dpr=4&quality=100&sign=680ea281&sv=1)
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
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.
If you have questions while providing liquidity in V3, check here for FAQ.
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.
Step 5 - Stake in V3 farms
![](https://docs.pancakeswap.finance/~gitbook/image?url=https%3A%2F%2F2908774936-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MHREX7DHcljbY5IkjgJ-1972196547%252Fuploads%252F2nZNL9Jv6ajexLuQaidz%252Fimage.png%3Falt%3Dmedia%26token%3D2261286b-7367-4de2-bcbe-43c4ef11cd38&width=768&dpr=4&quality=100&sign=36fa8674&sv=1)
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.
If you have questions while staking liquidity in V3 farms, check here for FAQ.
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.
Finished
That's it. You've migrated your farm staking and liquidity to the new PancakeSwap V3!
Last updated