By default, the address of your help center is a Zendesk subdomain, such as "mycompany" in mycompany.zendesk.com. However, you can map a subdomain of your own domain (such as support.mycompany.com) to your default Zendesk address. This feature is called host mapping (see About host mapping).
The workflow for changing the address consists of the following steps:
- Getting a domain name and subdomain (if you don't already have one)
- Making the subdomain an alias of your default address
- Specifying the new address
- Setting up a hosted SSL
After setting up a host-mapped, SSL-enabled domain, you can perform any of the following management tasks:
About host mapping
By default, the address of your help center is a Zendesk subdomain, such as "mycompany" in mycompany.zendesk.com. However, you can map a subdomain of your own domain (such as support.mycompany.com) to your default Zendesk address. This feature is called host mapping.
A host-mapped help center address looks as follows:
For example, suppose your company is called Mondo Cameras, and the address of your main website is mondocam.com. After the company signs up for Zendesk Support, the initial address of your help center might be something like mondocam.zendesk.com/hc. You can change the help center's address to a subdomain of your company's domain, such as support.mondocam.com/hc. You can't modify your support address to direct to a specific page within your subdomain, such as mondocam.com/community/hc.
Keep in mind that host mapping doesn't affect the URL of the agent interface. It only affects the external-facing URL of your help center. In the example, your agents will continue to see the default Zendesk URL mondocam.zendesk.com in the agent interface. If an agent tries to use the host-mapped URL in the agent interface (such as to get to a ticket page like support.mondocam.com/agent/tickets/52), the agent will be redirected to the default URL such as mondocam.zendesk.com/agent/tickets/52.
You can use host mapping for subdomains such as the "support" subdomain in support.mondocam.com. You cannot use host mapping for so-called "second level" domains, such as mondocam.com or mondocam.co.uk. In particular, you cannot use the name if it contains a DNS SOA (start of authority) record. To determine whether an SOA record exists, visit http://www.zoneedit.com/lookup.html. In the "DNS Lookup" box, enter the name and select the SOA record type. You can also use a command-line tool such as "dig" on Linux.
Getting a domain name and subdomain
If not already done, register a domain name and add a support-related subdomain to it. Consult your system administrator, if you have one, before proceeding.
Here are the steps:
- Purchase and register a domain name with a domain registrar.
For example, if your company is called Mondo Cameras, you might register a domain name called mondocam.com. You can purchase and register a domain name from any domain registrar, including GoDaddy, Yahoo! Domains, Namecheap, 1&1, Netregistry, or Register.com. For instructions, see the Help section on the registrar's website. For more information, see How to Register Your Own Domain Name by Christopher Heng on thesitewizard.com.
- After registering the domain name, use the registrar's tools to add a
support-related subdomain such as "support" or "help" or something along those
lines, for example, support.mondocam.com. You'll make the subdomain an alias of
your default Zendesk address in the next section.
See the Help section on the registrar's website for instructions on adding a subdomain.
Making the subdomain an alias of your default address
The next step is to make your subdomain an alias of your default Zendesk address. An alias is simply an alternate address for a website. For example, you can make the addresses "support.mondocam.com" and "mondocam.zendesk.com" interchangeable as far as web browsers are concerned.
To make your subdomain an alias of your default Zendesk address:
- Sign in to your domain registrar's control panel.
Use the login name and password that you created when you registered the domain name. If you don't have a domain name and a subdomain yet, see Getting a domain name and a subdomain.
- Look for the option to change DNS records.
The option might be called something such as DNS Management, Name Server Management, or Advanced Settings.
- Locate the CNAME records for your domain.
A CNAME record, or Canonical Name record, is a type of alias used by the Domain Name System (DNS). Among other things, you can use a CNAME record to make a subdomain an alias of an external website (see CNAME records on Wikipedia).
- Do one of the following:
- If you don't have a CNAME record for your subdomain yet, look for an option to add a new record.
- If you already have a CNAME record for your subdomain, look for an option to edit the record.
- Point the CNAME record from your subdomain (shown in the Host Record
field in the example below) to your Zendesk subdomain (shown in the Points
To field).
The UI and terminology may vary depending on your registrar, but the concepts are the same.
To configure a CNAME in the Cloudflare dashboard (only applies if you are using Cloudflare DNS)
- Log in to https://dash.cloudflare.com
- Choose the targeted website.
- Select DNS.
- Click Add record.
- From the Type dropdown menu, choose CNAME.
- In the Name field, enter the subdomain you want to configure (for example, <support> if you want to use support.mondocam.com).
- In the Target field, enter your Zendesk account or brand subdomain (for example, mondocam.zendesk.com).
- From the TTL dropdown menu, ensure it is set to Auto.
- Under Proxy status, ensure it is set to DNS only. If you need to change it, click the icon beneath Proxy status.
Specifying the new address
After making your subdomain an alias of your default Zendesk address, you need to specify the new address in your instance of Zendesk Support. If you omit this step, your new address will point to a Zendesk error page.
The instructions in this section apply if you only have one brand. If you added multiple brands, specify your addresses in Admin Center > Account > Brand management > Brands instead of Admin Center > Account > Appearance > Branding. See Adding multiple brands.
- In Admin Center, click Account in the sidebar, then select Appearance > Branding.
- Scroll down to Host Mapping and enter your subdomain and domain name.
- Click Save Tab.
Setting up a hosted SSL
SSL (Secure Socket Layer) is an encryption protocol that ensures secure communications with your website. You must configure an SNI-based SSL certificate for a host-mapped domain using one of the two methods below:
- Use the free SNI-based SSL certificate from Zendesk (recommended)
- Use your own SNI-based certificate
- Your host mapping must be set up correctly before you start. Because of potentially long lead times, consider your SSL options early when setting up Zendesk Support.
- If you use a Certification Authority Authorization (CAA) record to restrict which certificate authorities can issue certificates containing your domain names, you must add your certificate service to this record. Otherwise, the certificate service may deny the SSL certificate.
- Only one SSL certificate can be uploaded and used for all brands.
- There's no expected downtime if you change from a Let's Encrypt certificate to your own or vice versa. As a best practice, you should make these types of changes during periods of low traffic to account for the occasionally unanticipated delays in replacing records of this kind.
Getting a Zendesk-provisioned SSL certificate
- The SSL certificate covers up to 100 host-mapped domains. If you have more than 100 host-mapped brands, you'll need to provide your own certificate.
- Zendesk automatically renews the SSL certificate before it expires.
- When you add, update, or delete a host-mapped domain, Zendesk removes your current certificate and replaces it with a new certificate that covers the new host-mapped routes.
To get a Zendesk-provisioned SSL certificate
- In Admin Center, click Account in the sidebar, then select Security > More settings.
- Click the SSL tab at the top of the Security page.
- In Hosted SSL, click Enable Zendesk-provisioned SSL.
- Click Save.
It can take up to an hour to complete the request. If you have any issues, contact Zendesk Customer Support.
Providing your own SSL certificate
If you prefer not to use a Zendesk-provisioned SSL, you can get and upload your own SNI-based SSL certificate as described in this section. If you use your own certificate, Zendesk will not automatically renew it when it expires.
Getting your own SSL certificate
If you already have an SNI-based certificate for your host-mapped address, skip to Uploading the certificate below.
You can purchase an SSL certificate from a certificate authority such as DigiCert or Symantec, or from resellers such as Namecheap. You need to give the certificate authority a certificate signing request file (CSR) to create the certificate. You can generate the CSR, as described below.
If you have multiple host-mapped brands, you only need one certificate for all of them -- you don't need an SSL certificate for each brand. However, if you add a host-mapped brand, you must replace your existing certificate with a new one. Generate the new certificate as described in the procedure below. For more information on host-mapped brands, see Generating an SSL certificate for host-mapped brands.
To get your own SSL certificate
- In Admin Center, click Account in the sidebar, then select Security > More settings.
- Click the SSL tab at the top of the Security page.
- In the Hosted SSL section of the page, click I do not have a certificate, and then Generate a request. A certificate signing request file (CSR) is created and downloaded to your computer.
- Provide the CSR file to the certificate authority.
The certificate authority generates an SSL certificate and gives it to you so that it can be installed on our servers.
Certificate authorities charge a fee for each request, so keep the following tips in mind:
- Before you buy, make sure your certificate authority supports SHA-2 encryption and that the CSR file generated uses SHA-2 encryption.
- Make sure the certificate supports Server Name Indication (SNI) technology.
- If prompted, specify "Nginx," "Apache," or "Apache + mod_ssl" as the desired web server.
- After the certificate authority generates the certificate file, save it so you don't have to make another request.
Note: We strongly discourage using wildcard certificates. If your certificate is compromised anywhere on any of the services you use, the information on all your services is at risk. It means you will also have to replace the certificate everywhere it's used.
Once you have an SSL certificate, the next step is to upload it as described below.
Uploading the certificate
After purchasing the SSL certificate, the certificate authority will send you an email or direct you to a page where you can download the certificate. The instructions are often unclear about what files you really need or if you should prepare them before uploading them. For guidance, see Preparing your SSL certificate for upload to Zendesk.
After obtaining or preparing the SSL certificate as a PEM file as described above, upload it to our servers as follows.
- In Admin Center, click Account in the sidebar, then select Security > More settings.
- Click the SSL tab at the top of the Security page.
- In the Hosted SSL section of the page, click I have a certificate, then Upload certificate.
- Navigate to the PEM file and select it.
- If you have a private key associated with the certificate, click Upload private key and enter your passphrase, if any. You don't need a key if you generated the CSR file in Zendesk Support (see Getting a key file for upload).
- Click Save.
The certificate will be installed on our servers.
Updating the CNAME record
For either SSL option – you provide your own SSL certificate, or you use a Zendesk-provisioned SSL – Zendesk requires that the DNS record be a CNAME record that points to yoursubdomain.zendesk.com. DNS "A" records are not supported (see Making the subdomain an alias of your default Zendesk address above).
Reviewing the SSL status of a certificate
You can review the SSL status (CNAME check) of your host-mapped, SSL-enabled brands in the Zendesk Support interface.
- In Admin Center, click Account in the sidebar, then select Security > More settings.
- Click the SSL tab at the top of the Security page.
The SSL page displays information about your certificates:
Note: This view of the SSL page is only displayed if you have a host-mapped, SSL-enabled domain. - Refresh the page to run the SSL status check again.
Replacing a certificate
You can replace a certificate installed on Zendesk Support.
Zendesk will notify you when the certificate you provided is about to expire. If it expires before you can replace it, Zendesk will automatically replace it with a free, SNI-based SSL certificate from Let's Encrypt, a third-party certificate service (see Getting a Zendesk-provisioned SSL certificate). You can keep the certificate or replace it with your own.
- In Admin Center, click Account in the sidebar, then select Security > More settings.
- Click the SSL tab at the top of the Security page.
- Click I already have a certificate and follow the steps in Uploading the
certificate above. Note: This view of the SSL page only displays if you have a host-mapped, SSL-enabled domain.
- If you don't have a replacement certificate yet, click I do not have a certificate and follow the steps in Getting a SSL certificate, above.
Extending HTTP Strict Transport Security (HSTS) to one year
HTTP Strict Transport Security (HSTS) is enabled by default for host-mapped, SSL-enabled domains in Zendesk Support. HSTS instructs the user's browser to access your host-mapped domain only over SSL.
When a user types "http://shop.example.com" or just "shop.example.com" to access an SSL-enabled site that doesn't have HSTS, the user's browser briefly accesses the non-encrypted version of the site before being redirected to the encrypted HTTPS version. The redirect makes the user vulnerable to a man-in-the-middle attack, where a hacker could exploit the redirect to redirect the user to a malicious site.
When HSTS is enabled, the site instructs the user's browser never to load the site using HTTP. The browser automatically converts all such attempts to HTTPS requests, skipping the redirect that hackers can exploit for man-in-the-middle attacks. As long as the user accessed the site once using HTTPS, the user's browser will know to only use HTTPS when accessing it.
The browser remembers the site only for a specified period. By default, for Zendesk SSL-enabled domains, the period is one day. You can increase the period to one year.
To extend the period that the browser remembers your site to one year
- In Admin Center, click Account in the sidebar, then select Security > More settings.
- Click the SSL tab at the top of the Security page.
- Choose HSTS to instruct browsers to remember the site for up to one year.
- Click Save.
63 comments
Kerry Washington
The article does not map to my attempt to Host Mapping.
We setup the CNAME and the DNS is forward users to my domain: support.lite-wallet.org.
That is setup properly and we know because when you click on it, it redirects to Zendesk.
However, the page is the 404 type page.
Furthermore, in my dashboard when i try to set the domain into the host mapping window, it gives an error saying the CNAME is mis -set. Can someone help?
0
Jay Nelson
Will there ever be support for pathing on the host mapping? This would allow for usage of multiple tools during transitions and make the platform more versatile.
https://subdomain.domain.com/<path>
1
Kerry Washington
Following the step show above, we still are unable to save to the CNAME DNS record.
When you browse to the subdomain, it directs to a Zendesk 404 page. So, it suggests the routing is somewhat correct.
Is it a problem on the Zendesk side?
0
Gab Guinto
Hi Kerry,
We checked that address – support.lite-wallet.org – and it looks like the CNAME/DNS settings are misconfigured from your end.
You may want to review this section and check again if everything properly configured.
Hope this helps. Thanks Kerry!
0
Gab Guinto
Hi Jay!
This is not yet supported, and I'm afraid we could not tell for certain if this is in the roadmap soon. I recommend that you create a new post in the Support Product Feedback topic in our community to engage with other users who have similar needs and discuss possible workarounds. Conversations with a high level of engagement ultimately get flagged for product managers to review when they go through roadmap planning.
Thanks!
0
Guljeet Nagpaul
Can we have separate URL for support and gather. one is support.mydomain.com and other we want it to be community.mydomain.com
1
steve jones
what if we aren't using a subdomain and just using the root domain as our URL?
Can we not do this?
2
Joshua Small
Does host mapping impact `zat theme preview`? When I navigate to the URL generated by this command, I am redirected to the specified host mapping, and have no theme preview.
0
Narek Torosyan
Why should we disable Cloudflare proxy? It's not a solution. As Zendesk Guide doesn't have native 301 redirect functionality, Cloudflare was the only option for us to have redirects. Please either provide a redirect functionality or at least fix this bug, so that the Cloudflare proxy works for Zendesk, as for every other website on the internet.
-2
Permanently deleted user
We disabled two of our branded help centers and built a 3rd one to replace them both. Is it possible to map the two old domains to the new help center? There is no configuration option for this that I see, and we cannot make it happen in DNS settings (yet).
We tried making CNAME records for the two old domains like this:
HC1.example.com >> HC3.example.com
HC2.example.com >> HC3.example.com
That option led the user to a login page for HC3.example.com, which they should not see. They should just be on the main help center.
Then we tried:
HC1.example.com >> HC3.zendesk.com
HC2.example.com >> HC3.zendesk.com
This generates an error message from Zendesk saying that the help center is not available.
At first, I thought this was happening because I still had the original domains mapped to their Zendesk HCs, but I removed the mappings and the problem remains.
Any suggestions?
0
Erik Boudreault
We do not have any designated solutions for this but we do have an article on how you can redirect old articles to a new Help Center here:
https://support.zendesk.com/hc/en-us/articles/4408886627866-Redirecting-traffic-from-deleted-Help-Center-articles
Thank you!
0
simon
We setup our help.ourdomain.com CNAME as per these instructions, but when we hit help.ourdomain.com, Zendesk does a redirect to ourdomain.zendesk.com. How do we stop this redirection? I.e. keep help.ourdomain.com in the address bar, and thus allow cookie/siession sharing?
3
Jay Nelson
@Simon you need to add the /hc/en-us/ to ensure you are navigating to the help center.
0
simon
Thanks for the reply, help.ourdomain.com/hc/en-us/ just redirects to ourdomain.zendesk.com/hc/en-us. We need it to "stay" on help.ourdomain.com.
1
Jeff C
Hi Simon,
This happens if you haven't setup an SSL certificate as described in this article. Please ensure that you do to and you have options of either using a Zendesk provisioned one or uploading your own certificate.
0
Lois Green
One of my Zendeks is using Support Essential Plan and Guide Professional Plan. But I can't set the host mapping.
For example: ourdomain.zendesk.com doesn't redirect to support.ourdomain.com.
Do I need to upgrade Support from Essential to Team Plan?
1
Jeff C
Hi Lois,
That seems to be the case per this article. Look under the Legacy plans Legacy plans available November 11, 2015 - January 31, 2021 and host mapping is available on all Support plans except Essential.
0
Marina
The section "Specifying the new address" is out of date. The settings are no longer in Guide, but the new Admin Center. Had to search around for them.
0
Bob Rosenbaum
Our company was recently acquired. We have maintained our own zendesk subdomain for some years and now we have moved to the acquiring company's zendesk subdomain.
The technical change process described here went smoothly, however we have no way to direct users who still enter the old subdomain address to the new subdomain address (e.g., oldcompany.zendesk.com >> newcompany.zendesk.com).
Existing users land on a zendesk page that says the Help Center no longer exists, instead of being automatically directed to the new help center. How can we create a permanent redirect that will remedy this situation?
Thanks.
0
DJ Buenavista Jr.
Thank you for reaching out to Zendesk Support.
In regards to your inquiry, unfortunately, Zendesk cannot set up a redirect on your behalf since the following change will be implemented on your side.
We would advise making sure that your CNAME, host maps, and SSL are updated once you have changed the URL of your Help Center. You'll want to update any email forwarding and host mapping to point to your new support address and URL in sync with renaming your subdomain.
You can check our article, Renaming your subdomain for more information and best practices.
Thank you and have a wonderful day ahead!
Kind regards,
0
Darren Taylor
We've tried updating our URL for our help centre and asked our IT team to make the relevant edit to the CNAME, however we still get this error.
and the help centre is no longer accessible, so now I can't login to the support.
Any ideas?
0
Aaron Wenner
What happens to the original URLs once a support page is changed? Will the old links still work?
For example, let's say our app's "help" button directs users to https://examplecompany.zendesk.com/hc/en-us/articles/360029558972-help
We then change the domain so that our support page becomes https://support.examplecompany.com/
What will happen to the original link? Will it successfully redirect to https://support.examplecompany.com/hc/en-us/articles/360029558972-help
0
Dane
Hi Aaron,
Once you have properly setup host-mapping for your Zendesk subdomain, the original link will still be accessible.
Based on your example, if I access https://examplecompany.zendesk.com/hc/en-us/articles/360029558972-help it should route me to https://support.examplecompany.com/hc/en-us/articles/360029558972-help automatically.
0
Gigi Reist
Is it possible to download the Zendesk provided SSL certificate?
0
Cheeny Aban
Unfortunately no. You can only request one that will cover all your host-mapped domains but there is no option to download the certificate externally.
0
Ibrahim Al-Beladi
How should we handle CORS (Cross-Origin Resource Sharing) after host mapping in order to use all the APIs?
1
Jupete Manitas
If you are seeing messages in your browser's console window related to CORS then please check this troubleshooting guide - How can I troubleshoot CORS?. Otherwise, please reach out to the Support Advocacy team to have a closer look. Thank you!
0
Adam Moennig
Will changing this change the email address for support?
0
Brett Bowser
Host mapping won't affect the support address you have set up in your account. This will only change the URL the end-user sees when navigating to your help center.
Let me know if you have any other questions!
0
Goated
I did the above steps but help.goated.com still redirects to goated.zendesk.com. Why is this?
1