How to Set a Mastodon Display Name Different From Your Handle

In Mastodon, your handle is the unique identifier that people use to find and mention you. It typically looks like @username@instance.social. Your display name is the name shown on your profile and posts. By default, Mastodon sets your display name to match your handle username, but you can change it to any text you like. This article explains how to set a display name that is completely different from your handle, including the steps to edit it on the web interface and on mobile apps.

What the Display Name Does and How It Differs From Your Handle

Your handle is the permanent address of your Mastodon account. It is unique across the entire fediverse and cannot be changed without migrating your account. The handle appears in your profile URL and in mentions such as @alex@mastodon.social. The display name, on the other hand, is a customizable label that appears in your profile header, in post bylines, and in search results. It can be your real name, a brand name, a pseudonym, or anything else that fits within 30 characters.

Mastodon does not require your display name to match your handle. You can set it to any text that does not violate the instance rules. Changing the display name has no effect on your handle, your followers, or your ability to log in. It is purely cosmetic but helps others identify you more easily, especially if your handle is cryptic or hard to remember.

Steps to Set a Display Name Different From Your Handle

The process is identical on the Mastodon web interface and on most mobile apps, though the exact menu labels may vary slightly. Follow these steps to change your display name.

1. Open your profile settings
   On the web, click the gear icon or the Preferences link in the bottom-left navigation menu. On mobile, tap the hamburger menu icon and then tap Preferences or Settings.
2. Go to the Profile section
   In the left sidebar, click or tap Profile. This opens the profile editing page where you can change your display name, bio, avatar, header image, and other metadata.
3. Edit the Display name field
   Look for the text field labeled Display name. Delete the current content and type the new name you want to use. The field accepts up to 30 characters. You can include spaces, numbers, and most special characters, but not emoji or HTML tags.
4. Save your changes
   Scroll to the bottom of the page and click the Save changes button. On mobile, the button may be labeled Save or Update. After saving, your new display name appears immediately on your profile and in your posts.

To confirm the change, visit your own profile page. Your display name should now be different from your handle. If you see the old name, reload the page or clear your browser cache.

Common Mistakes and Things to Avoid When Changing Your Display Name

The Display Name Field Shows My Handle After Saving

This usually happens when you accidentally edit the wrong field. The Display name field is separate from the Username field, which is grayed out and cannot be changed. Make sure you are typing in the correct text box. If the issue persists, log out and log back in, then repeat the steps.

My Display Name Contains Emoji but They Do Not Appear

Mastodon does not support emoji in the display name field. If you paste an emoji, it will be stripped or replaced with a blank space. Use only standard Unicode characters, letters, numbers, and spaces.

I Changed My Display Name but It Still Shows the Old Name in Mentions

Mastodon caches profile information for performance. Other users may still see your old display name for a few minutes or hours. The cache clears automatically. You can ask a friend to reload your profile to see if the update has propagated.

My Display Name Is Too Long

The maximum length is 30 characters. If you exceed this limit, Mastodon will not save the change. Count your characters carefully before saving. You can use a character counter tool to verify.

Mastodon Display Name vs Handle: Key Differences

Item	Display Name	Handle
Purpose	Shows your chosen name on your profile and posts	Unique identifier for mentions and login
Editable	Yes, at any time	No, cannot be changed without account migration
Character limit	30 characters	Depends on instance, typically 30 or fewer
Appears in URL	No	Yes, as part of your profile URL
Uniqueness	Not required; multiple accounts can have the same display name	Must be unique on the same instance

Now you can set a display name that reflects your real identity or brand without affecting your handle. Try adding a short bio or a link to your website on the same profile editing page to make your profile more complete.