# Keet Username

* [How to set a username](#how-to-set-a-unique-username)
* [Rules for registering a username](#what-are-the-current-rules-for-registering-a-username)
* [Username usage](#what-can-i-do-with-my-username-right-now)
* [How to change a username](#can-i-change-my-username)
* [FAQ](#why-is-there-a-requirement-for-usernames-to-contain-a-digit)

### Why do I need a username in Keet?

In Keet, there are two different names you can set up: 

* <mark style="color:blue;">display name</mark> - the primary name shown to other users in the rooms, used for mentions, etc and is mandatory.
* <mark style="color:$primary;">username -</mark> allows other Keet users to find and start a chat with you, and is optional.&#x20;

You can set a username during the initial setup or add it later in your profile.\
If you prefer to remain undiscoverable by username, simply **skip this step.**\
You may use only a display name — visible in rooms and chats — which can be changed at any time.

***

### How to set a unique username?

You can set a username from any device. To do so, open **Profile** and click 'Set username' right under your display name. The following pop-up will appear:

<figure><img src="https://2790250247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLZAOh8HGmonUCseQFS35%2Fuploads%2F6IzflPrC0Oat8hnIhsF2%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-09-18%20161431.png?alt=media&#x26;token=39e9e452-beae-493d-94b2-25098a080413" alt="" width="358"><figcaption></figcaption></figure>

***

### What are the current rules for registering a username?

To register a username on Keet:

* It must be more than 3 and less than 32 characters.
* Only lowercase [ASCII letters](#user-content-fn-1)[^1] (a–z), numbers (0–9), and underscores (\_)  are allowed.
* It must contain at least **one digit**.
* It must be unique within the system.

<figure><img src="https://2790250247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLZAOh8HGmonUCseQFS35%2Fuploads%2F6wGYGhi4Tgc3TS2X8WRZ%2F2025-11-05%2014%2040%2059.png?alt=media&#x26;token=a0db56f8-49a7-47e5-a424-053da680ac8a" alt="" width="492"><figcaption></figcaption></figure>

{% hint style="info" %}
Once you set a username, it cannot be removed, but you can change it up to 5 times.
{% endhint %}

***

### What can I do with my username?

* Create a unique name.
* Display your username in the app.
* Be discoverable so other users can search for you to start a conversation.

<figure><img src="https://2790250247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLZAOh8HGmonUCseQFS35%2Fuploads%2FSx9qsY8UmKw0zZYycou0%2F2025-10-10%2011%2001%2012.png?alt=media&#x26;token=69ce7133-9d23-485a-acf4-b5f93a9c6877" alt="" width="392"><figcaption></figcaption></figure>

***

### Can I change my username?

You can change a username in the app. At the moment, users have 5 attempts to set the username (1 initial + 4 changes). &#x20;

<figure><img src="https://2790250247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLZAOh8HGmonUCseQFS35%2Fuploads%2F847f2OzIFlQSVisHWuL1%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-09-18%20173955.png?alt=media&#x26;token=e1ec83b7-9b4d-4f51-ad83-0011aad13d43" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="danger" %}
Please note that after changing the username, neither you nor other peers **can reuse** the old username again‼️
{% endhint %}

***

### Where are the usernames stored?

Keet introduced its Username Registry, a system that allows users to register unique usernames on Keet. It is available on both desktop and mobile versions of the app.&#x20;

The registry is fully peer-to-peer (P2P), meaning distribution happens entirely without centralized servers. However, it includes a gatekeeper system for write access, allowing Keet to moderate and control new username registrations to prevent abuse.

In Keet, your identity is tied to a unique seed phrase that cannot be changed.  There is no mechanism for sharing or giving away usernames.

<figure><img src="https://2790250247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLZAOh8HGmonUCseQFS35%2Fuploads%2FBa1cdMOCol1pst18nJtX%2FKeet%20website.png?alt=media&#x26;token=256f98a6-858c-49ef-bea1-9273e6fec1dd" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
Sharing a username would mean giving someone your seed phrase, which grants full access to your profile⚠️
{% endhint %}

***

[^1]: the basic English (Latin) alphabet characters