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

# Custom Domains

> Use a custom domain for your Suggix feedback portal.

Suggix supports custom domains, allowing you to serve your public feedback portal under your own brand domain, such as `feedback.example.com` or `ideas.example.com`.

To use a custom domain with Suggix:

1. Add your domain in the Suggix dashboard.
2. Configure DNS records with your domain provider.
3. Wait for DNS propagation and automatic SSL certificate provisioning.

## Add your custom domain

1. Navigate to the [Custom domain setup](https://www.suggix.com/_/settings/developer) page in your dashboard.
2. Enter your domain name. For example, `feedback.example.com` or `www.example.com`.
3. Click **Save**.

<img src="https://mintcdn.com/suggix/GVR9nA00G1hgv-zq/images/custom_domains.png?fit=max&auto=format&n=GVR9nA00G1hgv-zq&q=85&s=09d7d965c82c7a992d1ca5748e7716e1" alt="Custom Domain" width="1362" height="454" data-path="images/custom_domains.png" />

## Configure your DNS

1. On your domain provider's website, navigate to your domain's DNS settings.
2. Create a new DNS record with the following values:

```text theme={null} theme={null}
CNAME | your-subdomain | your-subdomain.suggix.com.
```

For `feedback.example.com`, the DNS record usually looks like this:

```text theme={null}
Type: CNAME
Name: feedback
Value: your-subdomain.suggix.com
```

<Tip>
  Each domain provider has different ways to add DNS records. Refer to your domain provider's documentation for specific instructions.
</Tip>

### DNS propagation

DNS changes typically take 1-24 hours to propagate globally, though it can take up to 48 hours in some cases. You can verify your DNS is configured correctly using [DNSChecker](https://dnschecker.org).

Once your DNS records are active, your documentation is first accessible via HTTP. HTTPS is available after Vercel provisions your TLS certificate.

### Automatic TLS provisioning

Once your DNS records propagate and resolve correctly, Vercel automatically provisions a free SSL/TLS certificate for your domain using Let's Encrypt.

This typically completes within a few hours of DNS propagation, though it can take up to 24 hours in rare cases. Certificates are automatically renewed before expiration.

### CAA records

If your domain uses CAA (Certification Authority Authorization) records, you must authorize Let's Encrypt to issue certificates for your domain. Add the following CAA record to your DNS settings:

```text theme={null} theme={null}
0 issue "letsencrypt.org"
```

## Troubleshooting

If the custom domain does not work after DNS propagation:

* Confirm the CNAME value points to your Suggix subdomain.
* Confirm there are no conflicting A, AAAA, or CNAME records for the same hostname.
* Check whether your DNS provider automatically appends the root domain to record values.
* Wait for SSL provisioning to complete after DNS starts resolving correctly.