When you sign up for Freshsurvey, your account comes with a default primary URL in the format .freshsurvey.io. If you prefer to have a custom URL, such as survey.yourcompany.com, you can configure your account to use a domain of your choice. This requires updating the account URL and verifying DNS settings. This article provides details about the prerequisites and steps for configuring a custom domain URL.
TABLE OF CONTENTS
What is an SSL certificate?
SSL is a form of encryption protocol that secures data between browsers and servers. SSL certificates are issued to websites & web portals to ensure a safer experience for businesses and customers.
When you create a survey account, the default URL provided by Freshsurvey is automatically enabled with SSL. For accounts with custom domains, the SSL certificate will be generated after you verify the DNS records in the DNS manager.
Prerequisites
Before proceeding with changing the survey account URL with a custom domain, please ensure the following:- Disable Proxying on the CNAME Record
If your DNS provider/registrar automatically activates a proxy on the CNAME record, it can keep the custom domain in a pending state. Please ensure to deactivate proxying on the CNAME record. Freshworks uses a tailored Cloudflare setup to ensure requests to the custom hostname are fully protected. - For Cloudflare users
If you use Cloudflare as your proxy/DNS provider, ensure that you temporarily prevent the subdomains. To do this:- On the Cloudflare Dashboard, go to Overview > Quick Actions > Zone Hold.
- Ensure to uncheck the option Also prevent subdomains.
If the option is already unchecked, no further action is required to release Zone Hold. - After the custom domain creation is completed, you can re-enable the option if necessary.
Note: Ownership of the zone and subdomains remain unchanged.
- CAA Record Configuration
If you have added CAA records for your domain, add pki.goog and letsencrypt.org to the records for your subdomain. - SSL Certificate Migration to Cloudflare
Freshworks is migrating to Cloudflare for SSL certificates, supporting the latest HTTPS standards. After migration, if SSL certificate renewal fails, you will receive an error notification on your account and registered email ID requesting immediate action to prevent account inaccessibility. You can also check the troubleshooting article for more information.
Change survey URL with a custom domain
- To add a custom survey URL:
- Go to 'Settings' on the left navigation bar and click on ‘Custom domain’.
- Enter a custom domain in the 'Custom domain URL' field in the format ‘custom.domain.com’.
- Click the 'Generate CNAME' button and copy the CNAME key and value.
- Verify Domain and add records in DNS Manager:
- A CNAME record (CNAME and value) will be generated. Save these values.
- Log in to your Domain Control Panel (for example, GoDaddy) and go to Admin tools > DNS Manager > Add CNAME record.
Note: This step may vary based on where you are hosting your domain, please contact your web hosting company for more help. - Paste the domain name and CNAME values copied from the Custom domain settings.
- If your Domain Host asks for a TTL (Time-To-Live), enter a value between 30 minutes and 1 hour, or you can leave it blank.
- Note: Domain/DNS verification is a mandatory step. Without DNS verification, you cannot proceed further. Before proceeding with the verification, ensure to check the Prerequisites section.
- Once you add the CNAME record, return to the custom domain settings page on Freshsurvey and click on 'Verify' button. On successful verification, the button will change to a green 'Verified' label.
- After you save the changes and complete the CNAME verification and mapping within your DNS, Freshworks initiates a request for the SSL certificate for the custom domain. This certificate safeguards your customers' sensitive information from any potential malicious activities by third parties. The SSL verification may take up to 24 hours to activate.
- Once the SSL Certificate is issued, return again to the custom domain settings page on Freshsurvey and click on 'Confirm custom domain' button.
- Once confirmed, your custom domain is set. All surveys sent to customers will now include the custom domain URL.
Notes: Until the SSL certificate is procured, your survey account with custom URL will be inaccessible.
