Custom domain mapping

Default domain

When you create a new project in Document360, it automatically assigns a default domain name in this format: project-name.document360.com.

For example, if you name your project Project Greenfield, the assigned domain will be project-greenfield.document360.com.

Editing a Default domain

You can create a more personalized web address that reflects your brand and preference by editing the default web address, which makes it easier for users to find and remember your site.

To edit the default web address,

1. In the left navigation bar of your Knowledge base portal, navigate to Settings () > Knowledge base site > Custom domain.

2. Click Edit domain in the Document360 provided domain field.

   The Edit subdomain dialog will appear.

   

3. Enter your preferred domain in the field.

   • If your preferred domain is unavailable, the Update button will be inactive. You will need to try a different domain.

   • If the domain is already in use, the Update button will remain inactive.

   • If your preferred domain is available, the Update button will be enabled.

4. Click Update to update the web address of your Knowledge base site.

 NOTE

Document360 provided domain and Custom domain cannot co-exist.

Creating a custom domain

You can strengthen your brand identity and provide a seamless experience for your users by mapping a custom domain to your knowledge base site, replacing the default Document360 URL with a domain that is entirely your own. You can configure a branded custom domain like help.yourcompany.com for your knowledge base site using the following steps:

1. Add the custom domain in Document360

2. Configure DNS with Document360

3. Verify the domain in Document360

Adding a custom domain in Document360

To add a custom domain,

1. In the left navigation bar of your Knowledge base portal, navigate to Settings () > Knowledge base site > Custom domain.

2. Click Add domain to add a custom domain for your knowledge base site.

   

3. Enter your custom domain name in the Enter your custom domain field and click View configuration.

Your custom domain will be added successfully to Document360.

Configure DNS with Document360

Once you have added a domain to Document360, you will need to configure your DNS to Document360’s server.

To do so, you’ll have to:

1. Configure TXT record in your domain registrar

2. Configure CNAME record in your domain registrar

Configuring the TXT record in your domain registrar

Once the domain is added in Document360, you’ll need to configure a TXT record within your domain registrar to link your custom domain to Document360’s servers.

1. Log in to your domain registrar (e.g., GoDaddy, Namecheap, Google Domains).

2. Navigate to DNS settings and click add new record.

3. Select the Record type as TXT Record from the dropdown.

4. Enter the Host and Value/Target details from Document360 into your domain registrar.

5. Then, click the Tick icon to save the changes.

6. Navigate to Document360, and click Verify. The status of the TXT record should change from Pending to Verified.

 NOTE

DNS record verification in Document360 may take some time to get verified.

Configure the CNAME record in your domain registrar

1. Click Add new record and select the Record type as CNAME Record.

2. Enter the Host and Value/Target details from Document360 into the domain registrar.

3. Then click the Tick icon to save the changes.

4. In Document360, the status of the CNAME record should change from Pending to Verified.

Verify DNS configuration

In Document360, the SSL record type is automatically provisioned upon DNS verification and may take some time to set up.

1. Click Retry verification.

2. Once verified successfully, a success message will appear and your custom domain will now be verified and accessible.

After mapping the custom domain, click the Go to your knowledge base site icon to view the change in the site URL.

 NOTE

If there is any issue in configuring the custom domain, check the Troubleshooting steps in the section below in this article.

Update your browser tab title after a domain or project name change

Changing your project name or custom domain does not automatically update the title shown in the browser tab. To update it:

1. Navigate to  Settings > Knowledge base site > Site customization.

2. Click Customize site button.

3. Expand the Site header & footer dropdown and select Home.

4. Click the Settings icon on the Home page.

5. Update the SEO Title field to reflect your new project or domain name.

6. Click Save.

 NOTE

This setting may require Owner or Admin-level permissions. If the fields are greyed out, contact a user with the appropriate permissions to make this change.

Common domain registrars

Below is a list of some common domain registrars:

• NameCheap - Support article

• Domain.com - Support article

• Google Domains - Support article

• Dreamhost - Support article

• Hover - Support article

• GoDaddy - Support article

• Cloudflare - Support article

• Bluehost - Support article

Post mapping issues

'Deceptive site ahead' message while accessing the site after successful custom domain mapping.

This means that Google has flagged the custom domain you have mapped as unsafe for browsing.

• To check the flagged status, use the Safe Browsing site status by Google.

• Type in your mapped domain and check if there are any issues.

• Resolve and fix the issues detected (Phishing attacks, malware-infested, violating community guidelines, etc.).

• Submit a review request from Google Search Console. Google will update the status and remove the warning from your website.

Here is a help article from Google support.

Load balancer

A load balancer distributes incoming traffic evenly across multiple servers, ensuring that your Knowledge base site remains fast and reliable, even during high traffic periods. This helps prevent any single server from being overloaded and enhances the overall performance and security of your site.

Upgrading the load balancer can provide additional benefits, such as improved security features and better traffic management.

Upgrading the load balancer

1. Navigate to Settings () > Knowledge base site in the left navigation bar in the Knowledge base portal.

2. In the left navigation pane, navigate to Custom domain > Custom domain mapping.

3. Click Upgrade.

4. Verify the custom domain mapping configuration in Document360.

5. Copy the CNAME record generated in Document360.

6. Set up the CNAME record in your domain registrar.

7. Verify the custom domain mapping configuration in Document360.

NOTE

• This upgrade does not cause any downtime. However, we recommend this upgrade during your off-business hours

• This upgrade is entirely free of cost

Please contact our support team for assistance.

Configuring a custom domain for Apex domains

When configuring a custom domain for Document360, you may want to use your Apex domain (root domain), such as abc.com without a subdomain like www. While configuring subdomains is straightforward, configuring Apex domains requires some extra steps, especially regarding DNS records.

DNS flattening is a method that allows you to use a CNAME record at the Apex (root) domain level, which not all domain registrars support. If your registrar does not support DNS flattening, you won’t be able to add a CNAME record for your Apex domain.

Configuring Apex Domains

If your domain registrar doesn't support DNS flattening (for example, GoDaddy), you can opt for a DNS provider that does, such as Cloudflare. Cloudflare offers free plans that include DNS flattening, enabling you to configure your custom domain for the Apex domain successfully.

For example, let’s say you're using GoDaddy, which does not support DNS flattening. In this case, switching to a DNS provider like Cloudflare will allow you to add a CNAME record for your Apex domain.

NOTE

For more information, read the article on CNAME Flatting from Cloudflare.

Using a custom SSL certificate

Use the SSL certificate provided by Document360 for your domain to ensure secure connections, as it offers automatic and seamless renewal for a smooth experience. Provide the following details to process your request to install a custom SSL certificate:

• Common Name (CN): The fully qualified domain name for the certificate.

• Organization (O): The legal name of your organization.

• Organizational Unit (OU): The department or division within your organization.

NOTE

The certificate is typically valid for 90 days. You will have to renew the certificate on time and provide us with the updated certificate so we can install it on your domain.

Troubleshooting

Domain verification failed

If you are having issues verifying your custom domain, ensure that the CNAME matches the domain host.

There are chances for any other record to be mapped in the place of CNAME (such as AAAA records). This would also cause an error.

Suggestion: To view your domain's CNAME, and other DNS information, use Digwebinterface or Google's DNS lookup, or any other DNS lookup tool available on the web

Once the correct CNAME is mapped, it might take up to 24 hours for successful mapping.

Wait time after DNS records are updated

If the CNAME match and the domain verification issue persist, the TTL (Time-To-Live) can be a possible reason.

If you're updating an existing DNS Record value, it may take time for the configured TTL to reflect globally. If the TTL is set to 3600 for a DNS record, then it may take up to 1 hour (3600 seconds) to reflect the DNS record value for the DNS Name server globally.

CAA restriction set by the domain registrar

Some domain registrars set a restriction that the SSL certificate should be provisioned by a specific CA (Certificate Authority).

For example, if a CAA DNS record has a value of 0 issues "letsencrypt.org", then only the Let's Encrypt (CA) will be able to generate a certificate for the particular custom domain. Other Certificate Authorities (DigiCert, in our case) would see this configuration and would deny generating an SSL certificate.

Check if you have any CAA records configured in the DNS configuration for the custom domain.

TXT Record Errors

TXT record not found

This error occurs when Document360 cannot detect the TXT record for your domain at the registrar.

Steps to resolve:

1. Log in to your domain registrar and navigate to DNS settings.

2. Add the TXT record exactly as shown in Document360:

   • Host: _doc360-verify. followed by your domain

   • Value: The unique verification code displayed in Document360

3. Save the record and click Retry verification in Document360.

 NOTE

DNS changes may take a few minutes to propagate. If the record was just added, wait a few minutes before retrying.

TXT record mismatch

This error occurs when a TXT record is found, but the value does not match the verification code generated by Document360.

Steps to resolve:

1. Go to your domain registrar's DNS settings.

2. Locate the existing TXT record for _doc360-verify. and check its value.

3. Compare it against the exact value shown in Document360.

4. Update the value to match exactly — even a single character difference will cause failure.

5. Save and click Retry verification.

Multiple TXT records detected

This error occurs when more than one TXT verification record exists for the same host, causing a conflict during verification.

Steps to resolve:

1. Log in to your domain registrar and navigate to DNS settings.

2. Search for all TXT records with the host _doc360-verify.

3. Delete all duplicate entries, keeping only the one matching the value shown in Document360.

4. Return to Document360 and click Retry verification.

TXT record not propagated

This error occurs when the TXT record has been added correctly but has not yet propagated across DNS servers globally.

Steps to resolve:

1. Confirm the TXT record has been saved correctly at your registrar.

2. Use Google's DNS lookup tool or Digwebinterface to check if the TXT record is visible.

3. Wait a few minutes and click Retry verification.

 NOTE

DNS propagation typically takes a few minutes but can occasionally take longer depending on your registrar's TTL settings.

Invalid TXT host

This error occurs when the host name of the TXT record has been entered incorrectly at the registrar.

Steps to resolve:

1. Log in to your domain registrar and locate the TXT record.

2. Verify that the host is set exactly as shown in Document360 — it should begin with _doc360-verify.

3. Correct the host name if it differs and save the record.

4. Click Retry verification in Document360.

CNAME Errors

CNAME record not found

This error occurs when Document360 cannot detect a CNAME record for your domain after TXT verification has passed.

Steps to resolve:

1. Log in to your domain registrar and navigate to DNS settings.

2. Add a new CNAME record:

• Host: Your custom domain (e.g., help.yourcompany.com)

• Points to: The CNAME value shown in Document360

3. Save the record and click Retry verification.

 NOTE

CNAME verification only begins after TXT ownership verification is successfully completed.

Incorrect CNAME target

This error occurs when a CNAME record exists but is pointing to the wrong destination instead of Document360's servers.

Steps to resolve:

1. Go to your domain registrar's DNS settings.

2. Locate the existing CNAME record for your custom domain.

3. Update the Points to value to match the exact CNAME target shown in Document360.

4. Save and click Retry verification.

CNAME is proxied (Cloudflare)

This error occurs when the CNAME record is routed through Cloudflare's proxy, which prevents Document360 from verifying the record correctly.

Steps to resolve:

1. Log in to your Cloudflare account and navigate to the DNS settings for your domain.

2. Locate the CNAME record for your custom domain.

3. Click the orange proxy icon next to the record to switch it to DNS only (grey cloud).

4. Save the change and click Retry verification in Document360.

 NOTE

Cloudflare's proxy (orange cloud) intercepts DNS resolution, which blocks Document360's verification. Switching to DNS only mode is required for successful verification.

Ownership not verified (CNAME blocked by TXT)

This error occurs when CNAME verification is attempted before TXT ownership verification has been completed.

Steps to resolve:

1. Return to the DNS records table in Document360.

2. Ensure the TXT record has been added correctly at your registrar.

3. Complete TXT verification first — CNAME verification will only proceed once TXT is confirmed.

SSL Errors

SSL provisioning blocked

This error occurs when SSL provisioning cannot begin because DNS verification (TXT and CNAME) has not been completed.

Steps to resolve:

1. Ensure both the TXT and CNAME records are verified successfully in Document360.

2. Once both records show a Verified status, SSL provisioning will begin automatically.

SSL provisioning failed

This error occurs when Document360 is unable to issue an SSL certificate for your domain.

Steps to resolve:

1. Check if any CAA records in your DNS are restricting SSL issuance. Ensure the following entries are present:

   • @ IN CAA 0 issue digicert.com

   • @ IN CAA 0 issue letsencrypt.org

   • @ IN CAA 0 issue pki.goog

2. Add any missing CAA entries and click Retry verification.

3. If the issue persists, contact Document360 support.

SSL still provisioning

This message appears when SSL setup is in progress and has not yet completed.

Steps to resolve:

1. No action is required — SSL provisioning is automatic.

2. Wait a few minutes and refresh the page to check the updated status.

3. If the status does not change after 15 minutes, click Retry verification.

General Verification Errors

Verification already running

This message appears when a verification attempt is already in progress.

Steps to resolve:

1. Wait for the current verification process to complete.

2. Do not click Retry verification while verification is running — this may cause a conflict.

3. Once the process completes, review the status of each record and retry if needed.

Verification incomplete

This error appears when some verification checks have passed but others have failed.

Steps to resolve:

1. Review the DNS records table in Document360 — failed records will be highlighted.

2. Fix only the records showing a failed or not verified status.

3. Records that have already passed do not need to be reconfigured.

4. Click Retry verification once the failing records are corrected.

Default Domain Errors

Domain already in use

This error appears when the subdomain you entered is already taken by another project.

Steps to resolve:

1. Enter a different subdomain name in the field.

2. The Update button will activate once an available name is entered.

3. Click Update to save the change.

Invalid domain name

This error appears when the subdomain entered contains unsupported characters.

Steps to resolve:

1. Ensure the subdomain uses only lowercase letters and hyphens.

2. Remove any special characters, spaces, uppercase letters, or leading/trailing hyphens.

3. Re-enter the corrected subdomain and click Update.

Resolving the error "This site can’t be reached" while configuring a custom domain

Error: This site can’t be reached

This error usually occurs when the CNAME record is not added promptly in your DNS after it's generated in Document360. If there's a delay, the CNAME may expire, leading to a failed domain verification.

Other possible causes include:

• DNS propagation delays

• Duplicate CNAME entries in your DNS

• Missing CAA records for supported SSL providers like Let’s Encrypt, DigiCert, or Google

Steps to resolve:

1. Check when the CNAME was configured

   • Confirm whether the CNAME record was added to your DNS immediately after creating it in Document360.

   • If not, the CNAME might have expired.

2. Remove and reconfigure the custom domain

   • Go to your DNS provider and remove the existing CNAME record.

   • Then, in Document360, delete the existing custom domain entry.

   • Wait 15 minutes before proceeding.

3. Add the CNAME record again

   • Navigate to Settings () > Knowledge base site in the left navigation bar in the Knowledge base portal.

   • In the left navigation pane, navigate to Custom domain > Custom domain mapping, and create the custom domain again.

   • Immediately copy the CNAME record and add it to your DNS provider with a TTL (Time To Live) of 5 minutes.

   • Return to Document360 and click Verify.

   • Wait a few minutes for the configuration to complete.

4. Check for DNS propagation

   • DNS changes typically take 2–4 hours, but in some cases up to 24 hours.

   • Wait for full propagation before rechecking the domain.

5. Verify DNS using Google Dig tool

   • Use Google Dig tool to check if your DNS records are showing correctly.

   • Look for any duplicate CNAME entries for the same hostname. If found, remove duplicates.

6. Check for CAA record conflicts

   • Use dnschecker.org to view CAA records for your domain.

   • If any CAA records are configured, ensure they allow Document360’s SSL providers:

     • @ IN CAA 0 issue digicert.com

     • @ IN CAA 0 issue letsencrypt.org

     • @ IN CAA 0 issue pki.goog

       Add these CAA entries to your DNS if missing.

Resolving errors such as “Your connection is not private” or “Your connection is not secure” while accessing the Knowledge base site

This error typically occurs due to the following reasons:

1. Issue: SSL certificate expired

1. Check if the SSL certificate has expired.

2. Visit the Knowledge base site and click the View site information option in the URL bar.

3. Click Connection is secure to view the SSL certificate details.

B. If the SSL Certificate has not expired, then try the below troubleshooting steps:

1. Try accessing the site from a different browser to rule out browser-specific issues.

2. Deactivate any website extensions in your browser and check again.

3. Verify if all users are experiencing the same issue to identify if it is user-specific or system-wide.

4. Clear your browser cache or switch to another browser, as this often resolves the problem.

C. VPN connection

1. Deactivate your VPN and try accessing the site again:

2. If deactivating the VPN resolves the issue, the VPN might be causing the problem.

3. Contact your IT team for further assistance.

D. DNS records issue

There may be issues with the DNS resolver if the DNS records have not been updated successfully.

1. Use a DNS checker (e.g., DNS Checker) to verify the DNS records.

2. Confirm if all the records have been updated successfully.

3. If the records are not properly synced, contact your DNS provider or domain registrar to ensure the DNS zone is correctly configured and synced for the domain.

Resolving the “Secure Connection Failed - SSL_ERROR_NO_CYPHER_OVERLAP” error while configuring a custom domain

Error: Secure Connection Failed - SSL_ERROR_NO_CYPHER_OVERLAP

This error usually indicates that the SSL certificate couldn’t be issued due to a mismatch in the CNAME configuration. If the custom domain does not point to the correct Document360 domain, SSL validation fails, resulting in the error.

Steps to resolve:

1. Go to dnschecker.org.

2. In the search bar, enter your custom domain and select CNAME from the dropdown.

3. Verify the result:
   The CNAME value should match the exact CNAME provided in the Document360 portal during domain setup.

4. If the CNAME is incorrect:

   • Remove the current custom domain from your Document360 project.

   • Correct the CNAME record in your DNS provider by adding the one provided in Document360.

   • Wait a few minutes, then reconfigure the custom domain in Document360 and verify again.

Once the correct CNAME is in place and verified, the SSL certificate will be issued successfully, resolving the error.