# Custom domains

Serve every link from your own subdomain, like docs.yourcompany.com. Included in paid plans.

## What changes

Connect a subdomain you own and every link in the workspace moves to it: `artifact.guru/acme/q3-roadmap` becomes `docs.acme.com/q3-roadmap`. Links you already sent keep working and forward to the new address.

*Two DNS records, four automatic checks, and the links move to your domain.*

Public and secret-code links open on your domain. Links that need a sign-in (Private and Email) keep opening on artifact.guru, where signing in works.

## Before you start

- A **Individual** or **Team** plan. See [Plans and billing](https://artifact.guru/docs/billing).
- A subdomain you control, such as `docs.acme.com`. Most DNS providers can't point a bare domain (`acme.com`) with a CNAME, so use a subdomain.
- Access to your domain's DNS settings.
- In a team workspace, an admin sets this up.

## Connect your domain

1. **Add the domain** Open **Settings**, find **Custom domain**, type the hostname and choose **Add domain**.
2. **Add the TXT record** It proves the domain belongs to your workspace. The name starts with `_artifact-guru`; Settings shows the exact name and value, with copy buttons.
3. **Add the CNAME record** It points the subdomain at artifact.guru.

   `domains.artifact.guru`
4. **Check now** Choose **Check now**. Settings checks ownership, the hostname, the certificate and HTTPS, and ticks each step as it passes. The certificate is issued for you.

DNS records for docs.acme.com:

```
Type    Name                         Value
TXT     _artifact-guru.docs            artifact-guru-verify=… (copy it from Settings)
CNAME   docs                         domains.artifact.guru
```

> **How long it takes.** DNS changes often show up within minutes, but can take up to a day at some providers. If a step still says waiting, give it a few minutes and choose **Check now** again.

## If a check doesn't pass

| Step | What to check |
| --- | --- |
| Ownership | The TXT name and value. Many DNS providers add your domain to the name for you, so enter only `_artifact-guru.docs`, not the full hostname. |
| Hostname | The CNAME points at `domains.artifact.guru`, and no A or AAAA record uses the same name. |
| Certificate | Usually done minutes after the CNAME is in place. Give it a little longer. |
| HTTPS check | Open the domain in a browser. Anything in front of it, such as another proxy, has to pass requests through. |

## Remove a domain

Choose **Remove** next to the domain in Settings. Links move back to their artifact.guru addresses. If a paid plan ends, the same happens automatically, and the links keep working at artifact.guru.

Source: https://artifact.guru/docs/domains