# 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="/files/kqJsWXEmaQJTwH5MVZAI" 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="/files/jmG556YAkSG4XEYGZoHF" 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="/files/HBC5wys5C6sbcXFswG1i" 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="/files/bpNpNjLiqLvPgkUPBhfZ" alt="" width="563"><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="/files/XzrV29RnUFvjBfEHbDTM" alt="" width="563"><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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.keet.io/installation-and-setup/keet-username.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.