Custom domains
Put a survey on your own domain, such as survey.yourcompany.com.
Custom domains are coming soon. This page describes how they will work once they are available.
A custom domain shows your survey at an address you own, such as
survey.yourcompany.com or yourcompany.com/feedback, instead of a Surbee
link. Custom domains are available on the Max and Enterprise plans. On
other plans the section shows a Max tag, and you can
upgrade to use it.
Connect a domain
- Open your survey's Share tab and find Custom domain.
- Type the domain into Domain, for example
survey.yourcompany.com. - Optionally, fill in Path to place the survey at an address such as
survey.yourcompany.com/feedback. Leave it empty to show the survey at the root of the domain. Paths can use lowercase letters, numbers, and hyphens. - Click Connect.
Surbee then lists the DNS records to add.
Add the DNS records
Add the records where you manage DNS for your domain, usually your domain registrar or DNS host. Each record has a Type, a Name, and a Value, with copy buttons so you can paste them exactly.
| Purpose | Type | Name | Value |
|---|---|---|---|
| Proves you own the domain | TXT | _surbee-verify. followed by your domain | The token Surbee shows you |
| Points the domain at your survey | CNAME | Your domain | The target Surbee shows you |
If you use a root domain (such as yourcompany.com with nothing in front), the
second record is an A record pointing at an IP address instead of a CNAME,
because root domains cannot use CNAME records. Surbee detects this and shows
the right type.
Sometimes a third record appears, labelled Extra check from our hosting provider. This happens when the domain was used with another hosting account before. Add it as shown.
Verification
Surbee checks your DNS every 20 seconds while the page is open, and you can click Check now at any time. Records that are in place show a tick and the word "done". The domain moves through these statuses:
- Waiting for DNS. Surbee has not found the records yet. DNS changes can take a few minutes, and sometimes longer, to spread.
- Verifying. Ownership is confirmed and Surbee is finishing setup.
- Securing. DNS is correct and the security certificate is being issued. This usually takes a few minutes.
- Live. The survey is available on your domain. Click Open to see it.
- Needs attention. Something is wrong. Read the message on the card, for example "The CNAME record does not point at Surbee yet.", fix the record, and click Check now.
More than one survey on a domain
Once a domain is connected, other surveys can use it too. Open another survey's Share tab, choose the domain under Your domain, give it a Path, and click Use this domain. Only one survey can sit at the root of a domain.
Removing a domain
- To take one survey off a domain, click Remove from domain on its Share tab. The domain stays connected for your other surveys.
- To disconnect a domain that is still being set up, click Disconnect, then Disconnect domain to confirm.
Common problems
- "This domain is already connected to another Surbee account." A domain can belong to one Surbee account. Remove it from the other account first.
- "You have already added this domain." Choose it under Your domain instead of connecting it again.
- Stuck on Waiting for DNS. Check that the record names and values match exactly, with no extra spaces, and that you did not add your domain to the name twice.