> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fimo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom domains

> Rename your default fimo.site URL, attach a domain you own, or buy a new one through Fimo.

`fimo domains` is the surface for everything URL-related on a project. Three resources live here — keep them straight:

| Resource              | What it is                                                     | Plan    |
| --------------------- | -------------------------------------------------------------- | ------- |
| **Default URL**       | The `<slug>.fimo.site` subdomain Fimo provisions for you       | Free    |
| **Custom domain**     | A hostname you own (e.g. `blog.example.com`), attached via DNS | Premium |
| **Registered domain** | A new domain bought *through* Fimo                             | Premium |

<Warning>
  A renamed URL or custom domain only resolves once the site is **published** (`fimo deploy --publish`). Before that it returns "Project Not Found".
</Warning>

## Rename the default URL (free)

Every project gets a `<slug>.fimo.site` URL. Rename the slug or claim a nicer one — free, instant, no DNS:

```bash theme={null}
fimo domains list                                # default URL + custom domains
fimo domains rename-default <slug>               # rename the default slug
fimo domains suggest-default                     # propose & claim a default URL
fimo domains suggest-default --base "Acme Blog"  # base suggestions on a custom name
```

## Attach a domain you own (Premium)

```bash theme={null}
fimo domains add blog.example.com                # attach a custom domain
fimo domains add blog.example.com --redirect-www # also add an apex → www redirect
fimo domains refresh blog.example.com            # re-check DNS / SSL (polls by default)
fimo domains remove blog.example.com             # detach it
```

Fimo prints the DNS records to copy into your registrar (Cloudflare, Namecheap, GoDaddy, …): a `CNAME` plus one or more `TXT` ownership-verification records. Add **every** record shown — some domains need more than one `TXT` entry to verify. Propagation is usually 15–30 minutes. Add `--wait` on `add` to block until SSL is active — handy in CI.

## Buy a domain through Fimo (Premium)

```bash theme={null}
fimo domains search <keyword> [--tld com,io] [--max-price 20]   # find available domains
fimo domains pricing <domain>                                  # one-shot price check
fimo domains buy <domain> [--years N]                          # create a checkout invoice
fimo domains owned                                             # list domains bought through Fimo
```

`fimo domains buy` creates an invoice and returns a `checkoutUrl` — **no money moves until you pay it in the browser**. Always `search` or `pricing` first and confirm the price before buying; registrations are generally non-refundable, and auto-renew is on by default (pass `--no-auto-renew` to turn it off).

<Note>
  Custom domains and domain purchases require a Premium plan; free users can still `list`, `rename-default`, `suggest-default`, `search`, and `pricing`. Prices vary by TLD — see [fimo.ai/pricing](https://fimo.ai/pricing).
</Note>

## What's next

<Columns cols={3}>
  <Card title="Deploy & publish" icon="cloud-arrow-up" href="/docs/deploy/overview">
    Publish so your domain resolves.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/docs/deploy/analytics">
    Track traffic once you're live.
  </Card>

  <Card title="Domains in Studio" icon="table-cells" href="/docs/studio/seo">
    Manage domains and SEO visually.
  </Card>
</Columns>