Hey there, developers!
We’re excited to introduce a new feature that will help you express yourself - Display Names!
We will be rolling this feature out slowly over the next few months and will update this post once the feature is turned on for everyone.
April 14 Update: We have begun another limited test rollout of the feature. As mentioned above, we will update this thread once the feature is ready to become available for everyone. Thank you!
June 8 Update: We have released the feature worldwide to 99% of users!
Display Names vs. Usernames
Usernames are globally unique names that can be used to precisely identify an account. They’re what you use to log in, and they’re used to identify the “real” you. After Display Names are rolled out, your username will be prefixed with an ‘@’.
Display Names are not unique. With the introduction of this feature, your Display Name is what will appear in places such as chat, player lists, or over your in-game character’s head.
Gone are the days of being CoolRobloxFan43732 - now, you can simply be CoolRobloxFan!
You will still use your unique username to log in, and users will still be able to see your current username, but you will now be able to choose a Display Name that you prefer to be shown to everyone, without the limitations of needing it be something unique (like your username)!
Most places around Roblox will start to show Display Name, although your unique username will still be visible on your profile.
How to set Display Names + Limitations
Once Display Names are rolled out, you may set your Display Name by navigating to your account details page.
- Updating your Display Name will not cost any Robux, and will be available to all users
- Display Names will still need to be verified by our filters
- If you choose not to set a Display Name, it will default to match your username.
- Currently, you are limited to changing Display Names once every 7 days.
- The length of your Display Name must be between 3-20 characters.
Develop with Display Names
We encourage you to use the player-chosen identity as much as possible in your games.
We suggest using Player.DisplayName
where you would normally use Player.Name
when it comes to front-facing content (custom chat, player lists, menus, etc). UserIds can still be used anywhere that you need a unique identifier, such as data saving or as a unique key within tables.
You may have noticed that Humanoid
has had a property named DisplayName
as well. When the engine loads a character for a Player
, it will automatically set the Humanoid.DisplayName
field to match the Player.DisplayName
field (unless a StarterHumanoid or StarterCharacter’s Humanoid is present to override this property).
You may write to Humanoid.DisplayName
as needed to set custom text for names over the heads of characters.
Resources
Additional documentation on how to use this new feature is available on the following pages: