This article describes how to rename your account subdomain. You can rename the subdomain of a paid account or a trial account, but not a sandbox account.
It's important to remember that if you decide to rename your subdomain (mycompany.zendesk.com), you are actually changing the address of your account. This change is immediate. Your Zendesk account will no longer be at your old URL, and unfortunately, Zendesk cannot set up a redirect on your behalf. As an alternative to renaming your subdomain, you might consider a simple account name change instead.
Host mapping (purchasing another domain that points to your Zendesk) is highly recommended as an alternative to changing your subdomain. This enables you to change the URL that your customers see when accessing your help center, without having to change the actual address of your agent interface or Zendesk account. To set up host mapping, see Changing the URL of your help center.
The tasks in this article will help alleviate the obvious concerns with renaming your subdomain, but there is always the possibility of surprise errors. Consider your entire workflow before making this change.
Step 1: Tasks before renaming your subdomain
Before renaming your subdomain you should update the following items:
CNAME, host maps, and SSL
First and foremost, if applicable, 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 to avoid missing any incoming tickets. This includes the wildcard email option (see Accepting wildcard email addresses for support requests). You should "flip the switch" during a slow period to be sure you have time to get everything in order.
You'll also want to ensure that any CNAME changes and certificate updates are done with your customer service team in advance to changing your subdomain. You will need to add a new CNAME for your new Zendesk subdomain with a new hostmap URL. Additionally, you'll need to set up a redirect from your old hostmap to your new one. This can take time to set up.
You can obtain a new SSL certificate by grabbing a Certificate Signing Request, and then uploading the new certificate to Zendesk Support. You need to install a new SSL certificate that covers the changed host mapped URL. For more information, see Replacing your current SSL certificate.
JIRA
If you've enabled the JIRA On Demand integration, you'll want to update your JIRA before changing your subdomain.
- In Admin Center, click
Apps and integrations in the sidebar, then select Apps > Channels apps.
- Disable the JIRA app.
- Rename your subdomain.
- Enable the connector again in JIRA.
- Select the Configure option in the connector setup.
- On the next screen, click on Complete set-up to install the App.
- Follow the on-screen instructions.
- Go back to Zendesk Support and check to see if the JIRA OnDemand App loads properly.
Step 2: Rename your subdomain
When you're ready to rename your subdomain, you can follow these steps to change. Only the account owner can rename the subdomain.
To rename the subdomain
- In Admin Center, click
Account in the sidebar, then select Appearance > Branding.
- In the Subdomain section, click Change your subdomain.Note: If you have multiple brands, click Brands menu instead of Change your subdomain.
- Enter your new subdomain into the dialog box as shown below, and then confirm your changes by clicking the Rename Subdomain button.
You'll need to refresh your browser to view the change.
The good news is not everything changes when you update your subdomain. All your existing users, tickets, organizations, and groups will automatically exist at your new URL. Additionally, your triggers and automations will be all set. While your users will need to re-login to your new Zendesk location, their profiles and ticket histories will still be intact.
Be sure to complete the tasks in the next section after you change your subdomain.
Step 3: Tasks after renaming your subdomain
After renaming your subdomain you should update the following items:
- Ticket sharing agreements
- CSAT representation/ Web Widget (Classic)
- Ticket replies
- Mobile SDK
- Zendesk Talk
- API tokens/credentials
- Single sign-on
- Zendesk Chat
- Status notifications
- Explore
Ticket sharing agreements
If you have any active ticket sharing agreements, you'll need to deactivate and recreate them after changing your subdomain. This includes any receiving ticket sharing agreements, which means that you'll also need the admins of those Zendesk accounts to recreate your sharing agreements to update the location of your Zendesk account.
Sharing on individual tickets will also no longer work. After you rename your subdomain and update your sharing agreements, you'll have to manually update all shared tickets to reflect the new sharing agreement.
CSAT representation/ Web Widget (Classic)
If you are using one or more instances of Web Widget (Classic), you will need to update them after changing your subdomain. You will also need to update your jQuery if you have made modifications to your CSAT representation. For more information on updating your satisfaction ratings in JSON format see, Displaying your last 100 satisfaction ratings.
You must update your widgets for your help center and website individually after you have changed your subdomain name.
To update Web Widget (Classic):
- In Admin Center, click
Channels in the sidebar, then select Classic > Web Widget.
- Click the Setup tab, if it is not already selected.
- Under the code box, click Copy to clipboard.
- To edit your widget on your website, go to the web page where you want to add the widget, then paste the updated code before closing HTML </HEAD> tag. You need to add the code to every webpage where you want to update the widget.
To update your help center widget:
- In help center, click Customize design in the tools panel, then click edit them.
- Select the Header template from the drop-down.
- Delete any existing help center widget code you have.
- Paste the updated code before the </HEADER> ; tag.
- Click save, then click Publish changes.
For more information on updating your widgets see, Using Web Widget (Classic) to embed customer service in your website.
Ticket replies
If you use email notifications, customer replies to ticket notifications sent prior to the subdomain change will not be received in your account or added as updates to those tickets. All ticket URLs sent in email notifications prior to the subdomain change will now also be invalid. To correct this, you'll want to update all of these with a public comment after changing your subdomain.
Start by creating a view of all the unsolved tickets in your instance of Zendesk Support. If you haven't done too much customization, you might already have this native view active in your account.
From this view, you can mass edit all your tickets with whatever comment you like. The new reply to email address will now be valid, and if you use the {{ticket.URL}} placeholder, it will populate with the updated ticket URL.
Mobile SDK
You will need to update the code on your Mobile SDK, so it will point to the correct Zendesk URL after you've updated your subdomain.
To update your Mobile SDK:
- In Admin Center, click
Channels in the sidebar, then select Classic > Mobile SDK.
- Locate the code snippet with your subdomain in your Android and iOS code.
- Give your developer the updated code snippets.
Zendesk Talk
If you experience issues with Zendesk talk after changing your subdomain, please send a request to our customer service team at support@zendesk.com.
API authentication
If you are using Zendesk API to fetch or send data in your account, make sure to update the subdomain you are pointing to so the API call doesn’t fail.
Example:
https://{OLDsubdomain}.zendesk.com/api/v2/tickets.json \ -v -u {email_address}:{password} https://{NEWsubdomain}.zendesk.com/api/v2/tickets.json \ -v -u {email_address}:{password}
Also, if your email address or your agents' email addresses changed, you might need to update your API tokens or credentials. For more information, see Generating a new API token in our Support tech notes.
Single sign-on
Both SAML and JWT pass the SSO request to Zendesk Access Consumer URL, which references your account subdomain. You will not be able to sign in via SSO until you update the subdomain.
For information on setting up SSO, see Using SAML for single sign-on and Setting up single sign-on with JWT (JSON Web Token).
Zendesk Chat
If you originally purchased Chat separately then later linked your Chat account with your Support account, your Chat account will fail to create tickets. You will need to contact our customer service team to make changes.
If you purchased Zendesk Chat and Zendesk Support together, updates occur automatically and no action is required.
Status notifications
If you have subscribed to Zendesk status notifications, you'll need to update your subscription for your new subdomain.
Explore
You may see some delayed (or missed) scheduled dashboard deliveries while your account re-synchronizes with Explore.
8 Comments
We are migrating our instance (merging with another instance as a separate brand) and want to keep our subdomain. Can we rename the current instance subdomain and use the current subdomain on the new instance (and brand)? If yes can it be done immediately?
Hi Anton,
Thank you for reaching out to Zendesk! It is possible to rename subdomain, yes. Can you kindly provide me the following:
I'm going to release the current subdomain so that you can still use that for the new account.
Best regards,
Shayne Traqueña | Associate Customer Advocate
Got question for us? We’re here for you on live chat!
Hi Zendesk Team
I am trying to change the subdomain.
Old Domain : https:/--------.zendesk.com/hc/en-us
New Domain : https://zendesk.-------.com/hc/en-us
But when I am trying to Login using https://zendesk.-------.com/access/normal.
It is still pointing to my old sub Domain.
Also. All my email from zendesk are coming from
support@----------.zendesk.com
--
This post has been redacted by the Zendesk Community Team.
Can you please help .
Thanks
We'd be glad to assist you regarding this. I recommend that you initiate a conversation with us, so one of our representatives will be able to dig deeper into your account the soonest
How are previously installed Zendesk Support Apps affected when the subdomain is changed? I currently have Salesforce, Slack, JIRA, and Lovely Views. Will they continue to work? Do I need to update them? Reinstall them?
Hi,
I am helping a client migrate an old support URL which is being redirected to ZenDesk via easyredir [dot] com. Here is the scenario:
Current:
support [dot] myclient [dot] com is CNAME'd to myclienthelp [dot] ssl [dot] zendesk [dot] com
Legacy help [dot] myclient [dot] com goes to easyredir [dot] com which redirects to myclienthelp [dot] ssl [dot] zendesk [dot] com
Any chance we can remove easyredir [dot] com by using the alternate subdomain name?
Yes, you may need to update them for them to work with your new Subdomain. For Jira, you need to update Jira first then disable the Jira App and re-enable it after you have renamed your subdomain.
I'm afraid that we don't have the information that you are asking for as it is concerning the easyredir removal. We don't usually support third-party redirects. You may reach out to easyredir for further support about your query.
What you can do instead is to do host mapping if possible. For more information, you may check our documentation Host mapping - Changing the URL of your help center.
Please sign in to leave a comment.