# Custom Domain

Using a custom domain allows your referral widgets and landing pages to appear as part of your own website. This improves trust with your audience and can help boost conversion rates.

### Set Up a Custom Domain

1. Go to **Settings > Custom Domain** in your account dashboard
2. Enter the subdomain you’d like to use — for example: *referral.mywebsite.com*

{% hint style="warning" %}
**IMPORTANT:**

1. Only enter the subdomain (e.g., referral.mywebsite.com), not your main domain (e.g., mywebsite.com)

2. **Do not** include `https://` or any slashes `/` at the end. Just enter the plain subdomain
   {% endhint %}

3. Click **Set Domain**

<figure><img src="/files/5X19sCsw1lxS8fQ1d1WO" alt=""><figcaption></figcaption></figure>

### Connect Your Domain

Once your domain is saved, ReferralHero will attempt to detect your domain provider.

#### Automatic DNS Setup

We now support automatic DNS record setup for:

* GoDaddy
* Cloudflare

If your domain is hosted with one of these providers, you will see a **“Connect Automatically”** option.

<figure><img src="/files/h2S85T0CdQsDBIwmwgiv" alt="" width="550"><figcaption></figcaption></figure>

Clicking this will:

* Automatically create the required DNS records in your DNS provider
* Remove the need for manual configuration
* Reduce setup errors and time

Once DNS records are successfully added, you will be redirected back to the Custom Domain page and shown the confirmation message.

#### Manual DNS Setup

For all other domain providers (e.g., Namecheap, GoDaddy DNS not connected, etc.), you will continue using manual setup:

1. After saving your custom domain, three CNAME records will appear in your ReferralHero account
2. Copy these CNAME records and add them to your domain’s DNS settings through your domain provider
3. Once added, return to ReferralHero and click **Verify DNS Settings**

<figure><img src="/files/AhjIVuqXgHUCIz33moXV" alt=""><figcaption></figcaption></figure>

#### DNS Propagation & Verification

DNS changes may take time to propagate across the internet.

* Typical propagation time: 15–20 minutes
* In some cases, it may take up to 24–48 hours

After records are added (automatically or manually), your domain may not verify immediately.

To improve reliability, ReferralHero also performs an automatic DNS verification check within 24 hours after DNS records are successfully added.

If verification does not succeed immediately:

* Wait 15–20 minutes before retrying
* Click **Verify DNS Settings** again after propagation
* The system will also retry verification automatically within 24 hours

**Example:**

**Before** (Default ReferralHero domain)

```
https://campaign.referralhero.com/MFe021deg0f2/dashboard
```

**After** (Custom domain)

```
https://referral.mywebsite.com/MFe021deg0f2/dashboard
```

Your referral pages are now branded under your own domain, making them feel more integrated with your site and increasing user trust.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.referralhero.com/settings/custom-domain.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.