Migration replaces one mint with another via a swap contract or claim site. Holders send old tokens and receive new ones at a defined ratio. This is high trust risk: you are asking users to trust that new tokens will be delivered and that old tokens will be honored.
You need to migrate your Solana token to a new mint — because of a mistake, an upgrade, or a bad initial launch — and every holder is asking "will my tokens work on the new mint?"
Announce the migration with clear reason, timeline, and swap ratio before you deploy the new mint
Snapshot current holders (see /snapshot-solana-token-holders)
Deploy the new mint with correct final settings (revoked authorities from day zero, immutable metadata)
What this means
Migration replaces one mint with another via a swap contract or claim site. Holders send old tokens and receive new ones at a defined ratio. This is high trust risk: you are asking users to trust that new tokens will be delivered and that old tokens will be honored.
Step-by-step
Announce the migration with clear reason, timeline, and swap ratio before you deploy the new mint.
Snapshot current holders (see /snapshot-solana-token-holders).
Deploy the new mint with correct final settings (revoked authorities from day zero, immutable metadata).
Deploy a swap program or use Streamflow / Jupiter Airdrop to distribute the new mint at the ratio.
Set a clear deadline for migration. After deadline, publish final unclaimed supply.
Update DEX Screener, Birdeye, CoinGecko, and any listings to point at the new mint.
Common mistakes
Migrating without a clear, verifiable reason — community loses trust.
Setting the swap ratio incorrectly — irreversible economic damage.
Skipping snapshot — impossible to audit fair distribution.