If you started moving your Mastodon account to a new instance but changed your mind, you have a limited window to cancel and return. Mastodon migrations are not instant; the system allows a short grace period before the transfer is finalized. During this time, you can reverse the process and keep your original account active without losing followers or posts. This article explains how to cancel a pending migration from your old instance, what happens during the reversal, and what to do if the migration window has already closed.
Key Takeaways: Cancel a Mastodon Migration Within the Grace Period
- Preferences > Account > Move from a different account: Use this menu on your old instance to remove the pending migration alias.
- Preferences > Account > Account settings > Delete account: Do NOT use this on your old instance; it will permanently remove your account and all data.
- Preferences > Account > Move to a different account: On your new instance, remove the redirect pointer to stop the migration from completing.
Why Mastodon Migration Has a Reversal Window
Mastodon migration is not an instant cutover. When you initiate a move from your old instance to a new one, the system creates a temporary alias that tells the old instance to redirect followers and profile lookups to the new account. This alias is not permanent. Mastodon gives you a grace period, typically 30 days, during which the migration can be reversed. The reversal window exists to prevent accidental data loss and to allow users to test the new instance before fully committing.
During the grace period, your old account remains active but is marked with a redirect notice. Followers who visit your old profile are redirected to the new one. If you cancel the migration within this window, the redirect is removed, and your old account returns to normal operation. After the grace period expires, the old account is automatically deleted, and the migration becomes permanent.
What Happens When You Reverse a Migration
When you reverse the migration, the alias link between the old and new instances is broken. Your old instance stops redirecting visitors to the new account. Any followers who already followed the new account will remain there unless they manually unfollow. Posts, media, and direct messages on the old instance are preserved exactly as they were before the migration started. The new instance account remains active but is no longer linked to the old one.
Steps to Cancel a Mastodon Migration and Return to the Old Instance
These steps assume you initiated a migration from OldInstance.social to NewInstance.social and want to cancel it within the 30-day window. You must have access to both accounts.
- Log into your old instance account
Open OldInstance.social and sign in with your original username and password. You must use the instance where you started the migration, not the new one. - Navigate to Preferences > Account
Click the gear icon in the top-right corner to open Preferences. Then select Account from the left sidebar. - Find the Move from a different account section
Scroll down to the section labeled Move from a different account. This section shows the alias pointing to your new instance. - Remove the alias by clicking the Remove button
Click the Remove button next to the alias entry. A confirmation dialog appears. Click Confirm to remove the redirect. - Log into your new instance account
Open NewInstance.social and sign in with the account you created during the migration. - Navigate to Preferences > Account > Move to a different account
On the new instance, go to Preferences > Account. Find the Move to a different account section. - Remove the redirect pointer
If the new instance still shows a redirect to the old account, click the Remove button next to that entry. This ensures the new instance stops pointing back to the old one. - Verify the reversal on your old instance
Return to OldInstance.social and check your profile. The redirect notice should be gone. Your followers should see your original profile without any migration banner.
If the Migration Window Has Closed or the Reversal Fails
If you missed the 30-day grace period, the old account is automatically deleted. Reversal is no longer possible. In this case, you have two options: continue using the new instance or create a brand new account on the old instance. If you create a new account on the old instance, you will start with zero followers and no post history. The deleted account cannot be restored.
The Remove Button Is Grayed Out or Missing
If the Remove button in the Move from a different account section is grayed out, the migration has already been finalized by the old instance. This usually means the grace period has expired. Contact the admin of your old instance to confirm the account status. Most admins cannot restore a deleted account, but they can verify whether deletion has occurred.
New Instance Shows an Error When Trying to Remove the Redirect
If the new instance refuses to remove the redirect, try logging out and back in on the new instance. Then repeat the removal steps. If the error persists, the new instance may have a cached alias. Clear your browser cache and cookies, then try again. If the issue continues, contact the new instance admin to manually remove the alias from the server side.
Mastodon Migration Reversal vs Account Deletion
| Item | Migration Reversal | Account Deletion |
|---|---|---|
| Effect on old account | Restores full functionality with all data intact | Permanently removes account, posts, and followers |
| Grace period | 30 days from migration start | 30 days from deletion request (if not confirmed) |
| Follower retention | Followers who migrated stay on new instance; old followers remain on old instance | All followers are lost |
| Posts and media | Preserved on old instance | Deleted permanently |
| Action required | Remove alias on old instance and redirect on new instance | Confirm deletion email or wait for auto-deletion |
If you are certain you want to return to your old instance, reversal is the safer choice. Deletion is irreversible and should only be used when you intend to leave Mastodon permanently.
You can now cancel a pending Mastodon migration within the 30-day grace period by removing the alias on your old instance and the redirect on your new instance. After reversal, verify that your old profile no longer shows a migration banner. For future migrations, remember that you can test a new instance for a full month before the move becomes permanent. To avoid accidental moves, always double-check the instance handle before initiating a migration.