# Addresses and subdomains

> How documents are addressed on your Hyperclay namespace, and the promoted subdomain and custom domain options.

Source: https://hyperclay.com/docs/addresses/

Your account is a namespace, and every document you create gets an address inside it. This page covers the default namespace URL, promoted subdomains, and custom domains.

## URLs & domains

Your Hyperclay account is a namespace. Every app you create lives inside it at `{your-username}.hyperclay.com/{app-name}.html`. Folders reflect in the URL: an app at `/projects/todo.html` lives at `{your-username}.hyperclay.com/projects/todo.html`.

If a folder is a [multi-page site](https://hyperclay.com/docs/multi-page-sites/), its pages also answer without `.html`. When `projects` is a site, `{your-username}.hyperclay.com/projects/todo` serves `projects/todo.html`, and opening the `.html` address redirects there. Outside a site, addresses do not change. See [Clean addresses](https://hyperclay.com/docs/multi-page-sites/#clean-addresses).

Three ways to reach your apps:

- **Default namespace URL**: `{your-username}.hyperclay.com/{app-name}.html`
- **Promoted subdomain** (paid): claim a dedicated subdomain like `{app-name}.hyperclay.com` for a flagship app, or for a whole [site folder](https://hyperclay.com/docs/multi-page-sites/#put-a-site-on-its-own-domain)
- **Custom domain** (paid):
  - Connect your own domain (e.g., `myapp.com`) to one app or to a site folder
  - Automatic SSL certificates
  - Minimal DNS setup: add a CNAME/A record at your registrar
  - Use one address per site: when you add `example.com`, keep **Also send www.example.com here** checked, and `www` redirects to the bare domain. A browser treats `example.com` and `www.example.com` as two separate sites, so a visitor who switches between them loses their drafts, saved app data, edit mode and share links, and search engines see two copies of your page.
