# Custom domain

> Serve your docs from your own domain, like docs.acme.com, on any plan.

Every site is served at `{slug}.typemark.dev`. Add one CNAME record and it's also served from your own domain, such as `docs.acme.com`. Custom domains are available on every plan, including Free, and HTTPS is set up for you.

Sites used to answer at `typemark.dev/docs/{slug}` as well. That address now redirects permanently (301) to your site's own address, keeping the rest of the path and the query: to your custom domain once it's verified, otherwise to `{slug}.typemark.dev`. Old links and bookmarks keep working.

## Set it up

<Steps>
  <Step title="Pick a subdomain">
    Use a subdomain such as `docs.acme.com` or `developers.acme.com`. Typemark verifies your domain through a CNAME record, and a bare domain like `acme.com` can't have one.
  </Step>
  <Step title="Add it in Typemark">
    Go to **Settings** > **Domain** and enter your domain. It saves automatically.
  </Step>
  <Step title="Add a CNAME record">
    At your DNS provider, add this record. The settings page shows the same values.

    | Type | Name | Value |
    |------|------|-------|
    | CNAME | `docs` | `cname.typemark.dev` |

    Replace `docs` with your subdomain.
  </Step>
  <Step title="Verify">
    Typemark checks pending domains every five minutes, so you don't have to come back. To check right away, click **Verify DNS**. Once the record is found, the domain shows **Verified**.

    DNS changes usually show up within minutes, but can take up to 48 hours.
  </Step>
</Steps>

Your site has to be live for the domain to serve it. See [Publishing](https://docs.typemark.dev/configuration/publishing).

## HTTPS

Once your domain is verified, Typemark issues a Let's Encrypt certificate for it on the first visit. There's nothing to configure.

## What changes once it's verified

- Your docs, `llms.txt`, Markdown pages, and [MCP server](https://docs.typemark.dev/ai/agent-ready) are served on your domain.
- Canonical URLs point to your domain, so search engines index it instead of `typemark.dev`.
- `{slug}.typemark.dev` keeps working.
- On Pro and Enterprise, your [custom code](https://docs.typemark.dev/configuration/custom-code) scripts start running, on your domain only.

## DNS provider examples

<Tabs>
  <Tab title="Cloudflare">
    1. Open your domain in the Cloudflare dashboard and go to **DNS** > **Records**.
    2. Click **Add record**.
    3. Type: `CNAME`, Name: `docs`, Target: `cname.typemark.dev`.
    4. Set **Proxy status** to **DNS only**.
  </Tab>
  <Tab title="Route 53">
    1. Open your hosted zone in the AWS console.
    2. Click **Create record**.
    3. Record name: `docs`, Record type: `CNAME`, Value: `cname.typemark.dev`.
  </Tab>
  <Tab title="Namecheap">
    1. Go to **Domain List** > **Manage** > **Advanced DNS**.
    2. Click **Add new record**.
    3. Type: `CNAME Record`, Host: `docs`, Value: `cname.typemark.dev`.
  </Tab>
</Tabs>

## Change or remove your domain

Edit or clear the field in **Settings** > **Domain**. A new domain needs verifying again. Each domain can belong to one project.

## Troubleshooting

<Accordion title="The domain won't verify">
  Check that the record exists and points at `cname.typemark.dev`:

  ```bash
  dig docs.acme.com CNAME +short
  ```

  The answer should be `cname.typemark.dev.` If it's empty, check the record's name for typos. Verification looks for the CNAME record itself, so a proxied or flattened record, such as a Cloudflare record with the orange cloud on, won't verify.
</Accordion>

<Accordion title="Can I use a bare domain like acme.com?">
  No. Verification needs a CNAME record, and DNS doesn't allow one on a bare domain. Use a subdomain such as `docs.acme.com`.
</Accordion>

<Accordion title="The domain is verified, but the site doesn't load">
  Make sure your site is live in **Settings** > **Publishing**. An offline site shows the "coming soon" page, and a project that has never built successfully isn't served on any domain.
</Accordion>
