---
title: Custom domains
description: Serve links on your hostname instead of lida.sh. Free includes 1 custom domain.
sidebar:
  label: Domains
  order: 6
---

Free includes 1 custom domain. Professional has 5. Growth is unlimited. See [Pricing](/pricing).

Generated ids and `lida.sh` slugs share one public namespace. Each custom domain has its own. A branded-domain link does not also publish on `lida.sh`. If a word is taken on `lida.sh`, add a hostname and retry with `--domain`.

## CLI

```bash
linkdash domains add docs.example.com
linkdash domains connect docs.example.com
linkdash domains verify docs.example.com
linkdash domains list
linkdash domains remove docs.example.com
```

Point DNS (CNAME or apex ALIAS plus a TXT Unkey returns), then verify. Domains offers one-click Domain Connect when Unkey returns an apply URL (Cloudflare, Vercel DNS, and others). `domains connect` / `GET /domains/:host/connect` returns that apply URL, or `null`. Records from add still work for every other provider. Assign with `--domain` on create or update:

```bash
linkdash links create --url https://example.com --slug welcome --domain go.example.com
```

## HTTP

```bash
POST /domains          { "hostname": "docs.example.com" }
GET /domains/:host/connect
POST /domains/:host/verify
DELETE /domains/:host
GET /domains
```

After add, create the DNS records returned (CNAME or ALIAS plus TXT), then verify. Assign with JSON `domain` on create/update.