> For the complete documentation index, see [llms.txt](https://docs.thoth.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thoth.id/web-app/register.md). # Register a Name Choose a term, add an optional avatar and register a name. Registration happens on a single screen. You pick how long you want the name for, optionally choose an avatar, and approve one transaction in Hathor Wallet. You get there by clicking **Register** on an **Available** search result, from the **Register** button on an unregistered name's page, or by going to `/register?domain=yourname.htr` directly. ![The registration page](https://2559695096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8NQqK3W76Bj7LGhFgkFC%2Fuploads%2Fgit-blob-936708f39592395364471927fab2407605229fbb%2Fregister-page.jpg?alt=media) ## 01 · Name The name you're registering, with an **Available** pill. **Change** takes you back to search. **Avatar · optional.** Click **Add avatar** and pick an image. A cropping dialog opens so you can frame the square that will be used. You can change or remove it before you register. The image is kept in your browser until you submit, so a reload won't lose it. You can skip the avatar and add one later from [Manage mode](/web-app/domain-page/profile.md). ## 02 · Term Use **−** and **+** to choose between **1 and 10 years**. Below the stepper: | Row | Meaning | | ------------------------------- | ------------------------------------------------------------------------------------- | | **Price** | HTR per year, read live from the contract. It depends only on the length of the name. | | **Renewal window after expiry** | How long after expiry the name can still only be renewed (30 days) | | **Name token** | The symbol of the token minted for the name: its first five characters, uppercased | | **Owner and manager** | You, with your address. Shown once your wallet is connected. | The price in the screenshots is the current **testnet** price; treat it as an example, not a price list. See [Naming Rules & Fees](/web-app/naming-rules-and-fees.md#what-a-name-costs). ## The summary At the bottom of the panel: | Field | Meaning | | ----------- | ------------------------------------------------------- | | **Total** | Price per year × the number of years | | **Balance** | The HTR balance of your connected wallet | | **Expires** | The date the name would expire if you registered it now | If your balance is below the total, a **Not enough HTR** message says how much more you need and shows your address with a copy button, so you can top the wallet up. The register button stays disabled until you have enough. If you chose an avatar, the summary also says **2 wallet signatures**: the name first, then the avatar once the name is confirmed. ## Submitting 1. If you haven't connected yet, the button reads **Connect wallet**. See [Connect Your Wallet](/web-app/connect-wallet.md). 2. Once connected, it reads **Register yourname.htr**. Click it. The app checks one last time that nobody has registered the name in the meantime. 3. Hathor Wallet asks you to approve the transaction. Review the amount and confirm. 4. The panel shows the transaction's progress: **Confirming**, with a timer, then **yourname.htr is yours**. You can stay on the page and watch, or leave: the transaction keeps being tracked under the bell. See [Transactions & Activity](/web-app/notifications.md). When it's confirmed, the panel offers **View yourname.htr** and **Register another**. ## What registration actually does * Creates the name in the thoth.id contract, with you as **owner**, **manager** and the address the name **resolves to**. * If this is your **first** name, it automatically becomes your [primary name](/web-app/domain-page/addresses.md#primary-name). * Mints a **token** that represents the name, held by the contract (*Deposited*). Its symbol is the first five characters of the name, uppercased, so `satoshi.htr` gets `SATOS`. * Sets the expiry date to the number of years you paid for. ## If you chose an avatar The avatar can't be written until the name exists. As soon as the registration confirms, the app uploads the image and Hathor Wallet asks for a **second signature** to save it to your profile. This happens wherever you are in the app. The panel shows it as **Approve the avatar in Hathor Wallet · Signature 2 of 2**. If you refuse that second request, or it expires, the name is still registered. Set the avatar later from [Manage mode](/web-app/domain-page/profile.md). ## Limits One address can manage at most **100 names**. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.thoth.id/web-app/register.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.