Custom domains are part of the Plus plan

> Custom domains let you serve **UserLoop surveys and quizzes** from **your own URL** (e.g. `survey.yourbrand.com`) with an automatic SSL certificate.

---

## Where to find it in UserLoop 1. Open the **survey or quiz** you want to publish.
2. Click the **Settings** tab.
3. Scroll to the **Custom Domain** section.

---

## What you’ll need

* A **Plus** subscription.
* Access to your domain’s DNS (Cloudflare, GoDaddy, Namecheap, Route53, etc.).
* A subdomain to use, e.g. `survey.yourbrand.com` or `feedback.yourbrand.com`.

> We recommend a **subdomain** rather than the root domain (`yourbrand.com`).

---

## How it works (quick summary)
1. Enter the subdomain you want to use in **Settings → Custom Domain**.
2. We show you **two DNS records** to add:
* **CNAME** pointing your subdomain to our edge (e.g. `fallback.user-loop.com`).
* **TXT** record for **SSL (ACME)** validation.
3. After DNS propagates, click **Refresh**. Your certificate is issued and the domain goes live.

---

## Step-by-step setup 1. **Choose your subdomain**

* In **Settings → Custom Domain**, enter something like `survey.yourbrand.com`, then save.
2. **Add the DNS records shown in UserLoop** * **CNAME** * **Name/Host:** `survey` (or the full subdomain, depending on your provider)
* **Target/Value:** `fallback.user-loop.com` * **TTL:** Auto or 5 minutes * **TXT** (ACME challenge)
* **Name/Host:** `_acme-challenge.survey.yourbrand.com` * **Value:** the long token shown in the UI * **TTL:** Auto or 5 minutes

> Some DNS providers append your domain automatically. If so, enter only the **host** (e.g. `_acme-challenge.survey`).
3. **Wait for DNS to propagate** * Usually minutes, sometimes longer depending on TTL.
4. **Back in UserLoop, click *Refresh*** * **Certificate Status** should move from **Pending Validation (TXT)** → **Issued**.
* **Hostname Status** should change from **Pending** → **Active**.
5. **Test** * Visit `https://survey.yourbrand.com` and confirm the survey/quiz loads over HTTPS (padlock icon).

---

## Status guide

* **Certificate Status: Pending Validation (TXT)** We haven’t detected the TXT record yet—add it exactly as shown.
* **Hostname Status: Pending** We’re not routing traffic yet—usually clears once the certificate is issued and the CNAME is visible.
* **Active** All set—your custom domain is live.

---

## Common pitfalls & fixes

* **Only added CNAME** → You must add **both** CNAME **and** TXT for SSL.
* **Wrong “Host/Name” format** → Match your provider’s expectations (host only vs full name).
* **Conflicting records** → Remove A/AAAA records on the same subdomain.
* **Cloudflare users (orange cloud)** → If validation stalls, set the CNAME to **DNS only** (grey cloud), click **Refresh**, then switch back to **Proxied** if desired.
* **Still pending after ~60 minutes** → Recheck the exact TXT token and CNAME target; ensure no typos.

---

## Changing or removing your custom domain

* **Change subdomain:** Update it in **Settings → Custom Domain**, add the **new** DNS records, and remove the old ones.
* **Remove custom domain:** Click **Delete** in the same section, then remove DNS records at your provider.

---

## FAQ **Does this work for quizzes too?** Yes—**the Custom Domain feature works for both surveys and quizzes**. **Can I use my root domain (`yourbrand.com`)?** We recommend a **subdomain**. Many DNS providers don’t allow CNAMEs at the apex and it may already host your site. **Is it secure?** Yes—HTTPS is automatic once we verify the TXT record and issue the certificate. **Do I need the Plus plan?** Yes—**Plus is required** for custom domains.

---

## Need help?
* Send us a screenshot of your DNS records (hide unrelated entries).
* Include your subdomain (e.g. `survey.yourbrand.com`) and DNS provider.
* Contact support from within the app or email us—we’ll verify DNS and certificate status.