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

# Custom Domain

> Use your own domain for your changelog

Transform your portal from `account.usestellar.com` to `changelog.yourcompany.com` for a professional, branded experience.

\[image]

## Why Use a Custom Domain?

* **Professional appearance** - changelog.yourcompany.com
* **Better SEO** - Domain authority benefits
* **Brand consistency** - Matches your main site
* **Trust** - Users recognize your domain

## Setup Overview

1. Choose your subdomain
2. Add DNS records
3. Verify in Stellar
4. SSL automatically provisioned

Total time: \~15 minutes (plus DNS propagation)

## Step 1: Choose Your Domain

### Recommended Patterns

* `changelog.yourcompany.com` ✅
* `updates.yourcompany.com` ✅
* `news.yourcompany.com` ✅
* `portal.yourcompany.com` ✅

<Warning>
  Use a subdomain, not your root domain. Root domains (yourcompany.com) require special configuration.
</Warning>

## Step 2: Configure DNS

### In Stellar

1. Navigate to **Portal** → **Settings** → **Custom Domain**
2. Enter your desired domain
3. Click **Generate DNS Records**
4. Copy the CNAME record shown

### In Your DNS Provider

Add this CNAME record:

```
Type: CNAME
Name: changelog (or your chosen subdomain)
Value: [your-account].usestellar.com
TTL: 3600 (or default)
```

\[image]

<Info>
  DNS changes typically propagate within 1-4 hours, but can take up to 48 hours in rare cases.
</Info>

## Step 3: Verify Domain

1. Return to Stellar after adding DNS records
2. Click **Verify Domain**
3. Wait for verification to complete
4. SSL certificate automatically generated

### Verification Status

* 🔵 **Pending** - DNS not detected yet
* 🟡 **Verifying** - DNS found, provisioning SSL
* 🟢 **Active** - Domain ready to use

\[image]

## Common DNS Providers

### Cloudflare

1. Select your domain
2. Go to **DNS**
3. Add record → CNAME
4. **Important:** Set proxy status to "DNS only" (gray cloud)

### GoDaddy

1. Domain Settings → DNS
2. Add → CNAME
3. Enter subdomain and target

### Namecheap

1. Domain List → Manage
2. Advanced DNS
3. Add New Record → CNAME

### Google Domains

1. DNS → Manage custom records
2. Create new record
3. Type: CNAME

\[image]

## Troubleshooting

### Domain Not Verifying?

**Check DNS propagation:**

```bash theme={null}
dig changelog.yourcompany.com CNAME
```

Should return:

```
changelog.yourcompany.com. 3600 IN CNAME [your-account].usestellar.com.
```

**Common issues:**

* Cloudflare proxy enabled (should be disabled)
* Typo in CNAME value
* DNS not propagated yet
* Conflicting records

### SSL Certificate Error?

* Automatic provisioning takes 5-10 minutes
* Clear browser cache
* Try incognito/private mode

\[image]

## Advanced Configuration

### Root Domain Setup

While not recommended, if you must use a root domain:

1. Contact support for special configuration
2. Requires ALIAS or ANAME record support
3. May have email delivery implications

### Multiple Domains

* Each portal supports one custom domain
* Redirects from old domain automatic
* Contact support for migrations

<Tip>
  Once your custom domain is active, all existing links automatically redirect. No need to update shared links!
</Tip>

## After Setup

### Update Your Links

* Website navigation
* App help menu
* Email footers
* Documentation

### Monitor Performance

* Check analytics for traffic
* Verify SEO indexing
* Test from different locations

Ready to brand your changelog? Add your custom domain and give your updates a professional home.