> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thig.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Custom Domains
> Serve thig.ai from your own domain with automatic SSL
# Custom Domains
Serve your thig.ai workspace from a custom domain like `prd.yourcompany.com`. Custom domains are available on **Business and Enterprise plans**.
Custom domains require the Business or Enterprise plan. If you're on a lower plan, you'll see an upgrade prompt on the domain settings page.
## Setup
### Step 1: Choose Your Domain
1. Go to **Settings > Custom Domain** (`/admin/settings/domain`)
2. Enter your desired domain (e.g., `prd.yourcompany.com`)
3. Click **Configure Domain**
thig.ai generates a unique verification token and shows you the DNS records to add.
### Step 2: Add DNS Records
You need to add **two DNS records** at your domain registrar (e.g., Cloudflare, Namecheap, Route 53, GoDaddy):
#### CNAME Record
| Field | Value |
| ---------------- | ------------------------------------------------------ |
| **Type** | CNAME |
| **Name/Host** | Your subdomain (e.g., `prd` for `prd.yourcompany.com`) |
| **Target/Value** | The CNAME target shown on the settings page |
| **TTL** | 300 (or "Auto") |
This routes traffic from your domain to the thig.ai servers.
#### TXT Record
| Field | Value |
| ------------- | ----------------------------------------------------------- |
| **Type** | TXT |
| **Name/Host** | `_verification.yourdomain.com` |
| **Value** | The verification token shown (starts with `airprd-verify-`) |
| **TTL** | 300 (or "Auto") |
This proves you own the domain.
Copy the DNS record values exactly as shown on the settings page. Extra spaces or missing characters will cause verification to fail.
### Step 3: Wait for DNS Propagation
DNS changes typically take **5–30 minutes** to propagate, but can take up to **48 hours** in rare cases. You can check propagation status using tools like [dnschecker.org](https://dnschecker.org).
### Step 4: Verify
1. Return to **Settings > Custom Domain**
2. Click **Verify Domain**
3. thig.ai checks both your CNAME and TXT records in real-time
4. If both pass, your domain is marked as **verified and active**
### Step 5: SSL Certificate
SSL is provisioned automatically by the hosting infrastructure after verification. Your custom domain will be accessible via `https://` immediately — no manual certificate setup required.
***
## Verification Details
The verification process checks two things:
| Check | What It Validates |
| --------- | ----------------------------------------------------- |
| **CNAME** | Your domain points to the correct thig.ai server |
| **TXT** | The `_verification` record contains your unique token |
Both checks must pass for the domain to be verified. If either fails, the settings page shows which record is missing or incorrect.
### Verification Rate Limiting
Domain verification requests are rate-limited to prevent abuse. If you see a rate limit error, wait a minute and try again.
***
## After Verification
Once verified:
* Your workspace is accessible at `https://yourdomain.com`
* The original `app.thig.ai` URL continues to work
* All API endpoints work on both domains
* SSL is active with automatic certificate renewal
***
## Managing Your Domain
### Changing the Domain
1. Go to **Settings > Custom Domain**
2. Click **Edit**
3. Enter the new domain
4. You'll need to repeat the DNS setup and verification for the new domain
Changing your domain requires re-verification. The old domain stops working immediately.
### Removing the Domain
1. Go to **Settings > Custom Domain**
2. Click **Remove Domain**
3. Your workspace reverts to `app.thig.ai`
### Domain History
The settings page shows a log of all domain changes:
* When the domain was added
* Verification attempts (successful and failed)
* When the domain was removed or changed
* Who performed each action
***
## Troubleshooting
| Issue | Solution |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **CNAME not found** | Check that you added the CNAME record at your registrar. DNS may still be propagating — wait 15–30 minutes and try again. |
| **CNAME points to wrong value** | Update the CNAME target to match the value shown in thig.ai settings. |
| **TXT not found** | Ensure the TXT record name is `_verification.yourdomain.com` (with the underscore prefix). |
| **TXT value doesn't match** | Copy the verification token exactly from the settings page. Some registrars add quotes — remove them if present. |
| **Verification fails after waiting** | Use [dnschecker.org](https://dnschecker.org) to confirm your records are visible globally. Some registrars have a delay before records go live. |
| **SSL not working** | SSL is provisioned automatically. If it takes more than a few minutes, verify the CNAME is correct — SSL depends on the domain routing correctly. |
| **Domain already taken** | Each domain can only be connected to one organization. If you previously used this domain, remove it from the old organization first. |
| **"Business plan required"** | Custom domains require a Business or Enterprise plan. Upgrade from **Settings > Billing**. |
## DNS Provider Examples
1. Go to your domain's DNS settings in Cloudflare
2. Click **Add Record**
3. For CNAME: Type = CNAME, Name = your subdomain, Target = the CNAME target from thig.ai, Proxy status = **DNS only** (gray cloud)
4. For TXT: Type = TXT, Name = `_verification.yourdomain.com`, Content = your verification token
5. Click **Save**
**Important:** Set the CNAME proxy status to "DNS only" (gray cloud icon), not "Proxied" (orange cloud). Cloudflare's proxy can interfere with SSL provisioning.
1. Go to **Domain List** > your domain > **Advanced DNS**
2. Click **Add New Record**
3. For CNAME: Type = CNAME, Host = your subdomain, Value = the CNAME target, TTL = Automatic
4. For TXT: Type = TXT, Host = `_verification`, Value = your verification token, TTL = Automatic
5. Click the checkmark to save
1. Go to **Hosted zones** > your domain
2. Click **Create record**
3. For CNAME: Record name = your subdomain, Record type = CNAME, Value = the CNAME target, TTL = 300
4. For TXT: Record name = `_verification.yourdomain.com`, Record type = TXT, Value = `"your-verification-token"` (wrapped in quotes), TTL = 300
5. Click **Create records**
1. Go to **My Products** > your domain > **DNS**
2. Click **Add** under Records
3. For CNAME: Type = CNAME, Name = your subdomain, Value = the CNAME target, TTL = 1/2 Hour
4. For TXT: Type = TXT, Name = `_verification`, Value = your verification token, TTL = 1/2 Hour
5. Click **Save**