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

# Custom Domains

> Use your own domain for your published projects

Use your own domain or subdomain for your HelloLeo projects. Perfect for production deployments and professional branding.

## Domain Options

### Default Subdomain

Every published project gets an automatic subdomain:

* Format: `your-project-name.helloleo.app`
* No configuration needed
* Works immediately after publishing

### Custom HelloLeo Subdomain

Choose your own subdomain from the **Publish Modal**:

* Format: `myproject.helloleo.app`
* Must be unique and available
* Change it anytime
* Follows naming rules (lowercase, numbers, hyphens)

### Custom Domain

Use your own domain:

* Format: `app.yourdomain.com`
* Requires DNS configuration
* Full control over your branding
* Available on Pro and Business plans

## Setting Up a Custom Subdomain

1. Click **"Publish"** to open the Publish Modal
2. In the **Subdomain** section, enter your desired subdomain
3. Click **Save** to update
4. Your project redeploys with the new URL

## Setting Up a Custom Domain

### Step 1: Configure DNS

Add a CNAME record pointing to HelloLeo:

```
Type: CNAME
Name: app (or your subdomain)
Value: custom.helloleo.app
TTL: 3600
```

<Note>
  CNAME records work for subdomains (e.g., `app.yourdomain.com`). For root/apex domains (e.g., `yourdomain.com`), use a DNS provider that supports CNAME flattening (such as Cloudflare) and point it to `custom.helloleo.app`.
</Note>

### Step 2: Add Domain in HelloLeo

1. Open the **Publish Modal**
2. Go to the **Custom Domain** section
3. Enter your domain (e.g., `app.yourdomain.com`)
4. Click **Verify Domain**
5. Wait for DNS verification and SSL certificate generation

### Step 3: Publish

Click **"Update Published Version"** to deploy with your custom domain.

## How It Works

When you publish with a custom domain, HelloLeo:

1. **Registers your domain** with our edge network
2. **Issues an SSL certificate** automatically via Cloudflare
3. **Routes traffic** from your domain to your published project

SSL certificates are provisioned automatically and renew without any action on your part.

## Domain Requirements

* **Subdomains**: 1-63 characters, lowercase letters, numbers, and hyphens
* **Cannot start or end with a hyphen**
* **Must be unique** - not already in use by another project
* **Reserved names**: www, api, admin, mail, ftp, localhost, test, staging, dev, app

## Troubleshooting

### Domain Verification Fails

* **Check DNS propagation**: Use [nslookup.io](https://www.nslookup.io) to verify your records
* **Wait for propagation**: DNS changes can take up to 48 hours
* **Verify CNAME target**: Must point to `custom.helloleo.app`
* **Check domain format**: No typos in domain name

### SSL Certificate Issues

* **DNS not propagated**: SSL provisioning requires DNS to resolve correctly first
* **Invalid DNS configuration**: Verify CNAME record points to `custom.helloleo.app`
* **Domain already in use**: Check if the domain is used by another project or service

### Domain Not Working

* **Check deployment status**: Ensure project is published
* **Verify SSL certificate**: Check certificate status in the Publish Modal
* **Clear browser cache**: Try incognito mode
* **DNS propagation**: May need more time

## Availability

Custom domains are available on:

* **Leo Pro** - Included with subscription
* **Leo Business** - Included with subscription

[View pricing](/pricing)

<CardGroup cols={2}>
  <Card title="Publishing Projects" icon="rocket" href="/features/publishing">
    Learn about publishing
  </Card>

  <Card title="Project Settings" icon="settings" href="/features/project-settings">
    Configure your project
  </Card>
</CardGroup>