> 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/quickstart.md). # Register Your First Name Register a name end to end, in five steps and one signature. Five steps, one signature, about two minutes. This page is the happy path; each step links to the full detail if you want it. **Before you start** you need [Hathor Wallet](/web-app/connect-wallet.md#what-you-need) with WalletConnect support and enough **HTR** to cover the first year. ## 1 · Find a name that's free Type the name you want in the search box on the landing page, on the search page, or in the top bar. The result appears as you type. You can leave the `.htr` off. ![A search result showing an available name](https://2559695096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8NQqK3W76Bj7LGhFgkFC%2Fuploads%2Fgit-blob-dd23cc94b8be517e313608051511582b32ee4ad0%2Fsearch-available.jpg?alt=media) **Available** means it's yours to take: the row shows the price per year. **Registered** means someone got there first. **Not supported** means the name breaks the [naming rules](/web-app/naming-rules-and-fees.md#what-makes-a-valid-name); the row says why and usually suggests a valid alternative. Click **Register**. → [Search for a Name](/web-app/search.md) ## 2 · Choose your term Pick how many years you want, from **1 to 10**. The price per year depends on how long the name is (shorter names cost more), and the **Total** is shown at the bottom. ![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) You can add an avatar here too, but it's optional and easy to do later. → [Register a Name](/web-app/register.md) ## 3 · Connect your wallet If you haven't yet, the button reads **Connect wallet**. On desktop, scan the QR code with Hathor Wallet and approve the session. On a phone, the button opens Hathor Wallet directly. ![The WalletConnect dialog](https://2559695096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8NQqK3W76Bj7LGhFgkFC%2Fuploads%2Fgit-blob-8bddbe555d54554a17ffd2736db63c2eabbbeb30%2Fconnect-wallet-modal.jpg?alt=media) Connecting only shares your address. It never lets thoth.id spend anything on its own: every transaction comes back to your wallet for you to approve. Once you're connected, your **Balance** appears next to the total, so you can see whether you can cover it. → [Connect Your Wallet](/web-app/connect-wallet.md) ## 4 · Approve the transaction Click **Register yourname.htr** and approve the transaction in Hathor Wallet. The name isn't yours until that transaction confirms on-chain, which usually takes about 30 seconds. The page shows **Confirming** with a timer, then **yourname.htr is yours**. You can leave the page meanwhile; the bell in the top bar keeps tracking it. → [Transactions & Activity](/web-app/notifications.md) ## 5 · You're done Click **View yourname.htr** to open your name's public page. Your new name is also in **My names**, marked with a star: your first name automatically becomes your **primary name**, the one thoth.id shows instead of your address. ![My names](https://2559695096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8NQqK3W76Bj7LGhFgkFC%2Fuploads%2Fgit-blob-f8cc5007b2a78a5b586e6a744a5c32ddd07b6387%2Fmy-names.jpg?alt=media) → [My Names](/web-app/dashboard.md) *** ## Using your name Your name resolves to your wallet address, so anyone can send you funds using `yourname.htr` instead of a long string of characters. Your name's page also has a QR code and a shareable link. This works in **Hathor wallets** to begin with, and then in any other wallet or application that integrates thoth.id. Support depends on the app you're using having built it in; where it hasn't, your plain address still works exactly as before. Developers can resolve names in their own applications with the [SDK](/sdk-reference/name-methods/resolvename.md). ## Two things worth knowing {% hint style="warning" %} **Your wallet controls your names.** There is no thoth.id account and no password reset. Whoever controls the address controls the names registered to it, so if you lose access to your wallet, you lose the names with it. Your wallet's seed phrase backup is the only way back in. Back it up, and never share it with anyone, including anyone claiming to be from thoth.id. {% endhint %} {% hint style="info" %} **Names expire.** You bought a term, not a permanent right. thoth.id warns you as the date approaches, and there's a 30-day renewal window after it passes during which the name can still be renewed. Once that ends, anyone can register it. See [Renew a Name](/web-app/renew.md). {% endhint %} ## Where to next * Add an avatar and a bio → [Profile](/web-app/domain-page/profile.md) * Publish links, socials or anything else on-chain → [Records](/web-app/domain-page/records.md) * Understand owner vs manager, and how to sell a name → [Ownership](/web-app/domain-page/ownership.md) * Something went wrong → [Troubleshooting](/web-app/troubleshooting.md) --- # 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/quickstart.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.