Mastodon Migration Alias Cleanup: How to Remove Old Aliases
🔍 WiseChecker

Mastodon Migration Alias Cleanup: How to Remove Old Aliases

After moving your Mastodon account from one instance to another, an alias remains on your old profile pointing to the new account. This alias helps followers find you, but it also keeps a permanent link to your old server. If you want to fully delete the old profile or stop the alias from showing on your new account, you must remove it manually. This article explains what a migration alias is, why you might want to remove it, and the exact steps to clean it up on both the old and new Mastodon instances.

Key Takeaways: Removing Old Mastodon Migration Aliases

  • Preferences > Account > Delete account: Permanently removes the old profile and its alias from the old instance.
  • Preferences > Account > Move from a different account: Shows the current alias relationship; you can cancel it by removing the redirect from the old profile.
  • Old instance admin or self-service: Some instances let you manually delete the alias in account settings if deletion is not possible.

ADVERTISEMENT

What Is a Mastodon Migration Alias and Why Remove It

When you use Mastodon’s account migration feature, the system creates an alias on your old profile. This alias displays a notice that says “This account has moved to @newusername@newinstance.social” and includes a direct link to your new profile. The alias is stored on the old instance’s database. It does not affect your new account’s content or followers, but it does keep the old account active in a read-only state.

You might want to remove the alias for several reasons. The old instance might be shutting down or you no longer trust its administration. You may have changed your mind about the move and want to return to the original instance. Or you simply want to clean up your digital footprint and delete the old profile entirely. Removing the alias requires action on the old instance because that is where the alias record exists. The new account has no direct control over the alias.

How the Alias Is Created During Migration

The migration process uses a two-step handshake. First, you create an alias on the old account by entering your new account’s handle in Preferences > Account > Move from a different account. Second, you confirm the move on the new account. After the move completes, the old profile automatically shows the redirect message. This message is the alias. It cannot be removed by simply editing the old profile’s bio or settings — it requires either deleting the old account or manually clearing the alias record.

Steps to Remove a Migration Alias From Your Old Mastodon Account

Removing the alias depends on whether you still have access to the old account and whether the instance allows account deletion. The most straightforward method is to delete the old account entirely. If deletion is not possible, you can ask the instance admin to remove the alias manually.

Method 1: Delete the Old Account (Recommended)

  1. Log in to your old Mastodon instance
    Open the old instance’s website in your browser. Sign in with the username and password for the account that has the alias.
  2. Open Preferences
    Click the gear icon or your avatar in the top right corner. Select Preferences from the dropdown menu.
  3. Go to Account settings
    In the left sidebar, click Account. Scroll down to the bottom of the Account settings page.
  4. Click Delete account
    Look for the section labeled Delete account. Click the red Delete account button. A confirmation dialog appears.
  5. Enter your password and confirm
    Type your old account password into the field. Click the red Delete account button again. The account and its alias are permanently removed. This action cannot be undone.

After deletion, the alias no longer exists. The new account remains unaffected. Followers who visit the old profile URL will see a 404 page or a “page not found” error.

Method 2: Cancel the Alias Without Deleting the Account

If you want to keep the old account active but remove the alias, you can cancel the migration redirect. This method works only if you still have access to the old account.

  1. Log in to the old instance
    Sign in to the old Mastodon account that has the alias.
  2. Open Preferences > Account
    Click Preferences, then click Account in the sidebar.
  3. Find the Move from a different account section
    Scroll down to the section titled Move from a different account. This section shows the alias you created during migration.
  4. Click Remove alias
    Click the Remove alias button next to the alias entry. A confirmation dialog appears.
  5. Confirm the removal
    Click Remove alias again. The redirect message disappears from your old profile. The alias is gone.

Note that removing the alias does not reverse the follower migration. Followers who already moved to the new account stay there. The old account simply stops showing the redirect notice.

Method 3: Ask the Instance Admin to Remove the Alias

If you no longer have access to the old account or the instance does not allow self-service deletion, contact the instance admin. Send an email or a support ticket to the old instance’s administration. Provide the exact username and the instance URL. Ask them to delete the account or remove the alias from the database. Not all admins will comply, especially if the instance has strict data retention policies. In most cases, admins will delete the account upon request.

ADVERTISEMENT

What Happens After the Alias Is Removed

Once the alias is removed, the old profile no longer shows the redirect message. If someone visits the old profile URL, they see the old account’s posts and bio without any migration notice. The new account remains unchanged. Followers who already migrated are not affected. The alias removal only affects the visibility of the redirect on the old profile.

If the Old Profile Still Shows the Alias After Removal

Sometimes the alias persists for a few minutes due to caching. Wait 15 to 30 minutes. Clear your browser cache or open the old profile in a private browsing window. If the alias still appears, the removal may not have saved. Log back into the old account and repeat the cancellation steps. Ensure you click the Remove alias button and confirm the action.

If You Cannot Log Into the Old Account

Loss of access to the old account is the most common obstacle. If you forgot the password and the instance does not offer password reset, the alias remains. You can ask the admin to delete the account. If the admin does not respond, the alias stays until the instance shuts down. In that case, the alias eventually disappears when the server goes offline.

Mastodon Migration Alias vs Account Deletion

Item Remove Alias Only Delete Old Account
Effect on old profile Redirect notice removed, profile stays active Profile and all data permanently deleted
Effect on new account None None
Follower migration Not reversed Not reversed
Access to old account Required Required
Reversibility Reversible (can re-add alias) Irreversible

This comparison helps you decide which approach fits your situation. If you plan to use the old account again, remove the alias only. If you want a clean break, delete the account entirely.

You now know how to remove a Mastodon migration alias from your old account. The quickest method is deleting the old account if you no longer need it. If you want to keep the old account active, cancel the alias in Preferences > Account > Move from a different account. For accounts you cannot access, contact the instance admin. After cleanup, consider updating your new account’s bio to clarify that the old profile is no longer in use. This extra step helps followers who may still find the old account through search engines.

ADVERTISEMENT