Renaming your subdomain

<body>
<p id="docs-hc-snippet" style="display: none;">Your subdomain is part of the URL address you use to access your Zendesk account. Your subdomain uniquely identifies your Zendesk account on the network.</p>
<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>

<div class="article-banner" id="suite_all">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

<div class="article-banner" id="support_all">
<table>
<tbody>
<tr>
<td>
<strong>Support</strong>
</td>
<td>Team, Professional, or Enterprise</td>
</tr>
</tbody>
</table>
</div>

</div>
<div id="docs-ai-summary">
<p id="docs-ai-summary-toggle">Summary: <span id="up-triangle">◀</span><span id="down-triangle">▼</span></p>
<p id="docs-ai-summary-content">You can rename your account subdomain to change your Zendesk URL, but it takes effect immediately and requires updating email forwarding, integrations, API calls, SSO, widgets, and other settings. Consider host mapping as an alternative to avoid disruptions. After renaming, update ticket sharing, mobile SDK, chat, workforce management, and notify users of the new URL to maintain smooth support operations.</p>
</div>

<div class="body">

<p class="p">Your subdomain is part of the URL address you use to access your Zendesk account. Your
subdomain uniquely identifies your Zendesk account on the network. </p>
<p class="p">You must be the account owner to rename a <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408883411354#topic_swn_h2f_3xb" target="_blank">subdomain</a>. If you aren't the account owner,
you can <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408822084634#topic_xkh_3lm_ygb" target="_blank">find the account owner</a> and request they make
the change. You cannot rename the subdomain of a sandbox account.
</p>
<p class="p">Zendesk can't change your account's subdomain for you. If you can't find the account
owner, work with your IT administrators. If you can’t resolve this, contact <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408843597850" target="_blank">Zendesk Customer Support</a> to initiate a security review.</p>
<p class="p">Renaming your subdomain takes effect immediately. Your Zendesk account will no longer be
at your old URL, and Zendesk cannot set up a redirect on your behalf. Consider your
entire workflow before making this change.</p>
<div class="note warning">
<span class="warningtitle">Warning:</span> Renaming your subdomain (<em class="ph i">mycompany.</em>zendesk.com) actually
changes the address of your account. Be sure you read and understand the <a class="xref" href="#topic_vcg_jvs_nvb">Important considerations before renaming
your subdomain</a>.</div>
<p class="p">This article covers the following considerations and updates you will need to make:</p>
<ul class="ul" id="topic_mxq_1cj_dvb__ul_vd5_fvs_nvb">
<li class="li"><a class="xref" href="#topic_fxc_dmg_y3c">Identifying your subdomain</a></li>
<li class="li"><a class="xref" href="#topic_vcg_jvs_nvb">Important considerations before
renaming your subdomain</a></li>
<li class="li"><a class="xref" href="#topic_ahm_lws_nvb">Step 1: Tasks before renaming your
subdomain</a></li>
<li class="li"><a class="xref" href="#topic_ffp_rrv_3kc">Step 2: Rename your subdomain</a></li>
<li class="li"><a class="xref" href="#topic_gwv_qpt_nvb">Step 3: Tasks after renaming your
subdomain</a></li>
</ul>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_fxc_dmg_y3c">
<h2 class="title topictitle2" id="ariaid-title2">Identifying your subdomain</h2>
<div class="body">
<p class="p">If you have not set up host mapping, your subdomain is part of the URL address you
use to access your Zendesk account. Your subdomain uniquely identifies your Zendesk
account on the network.</p>
<p class="p">The convention for accessing your Zendesk account is
https://<em class="ph i">yoursubdomain</em>.zendesk.com. An example would be
https://mayfield.zendesk.com, where <em class="ph i">mayfield</em> is your subdomain. </p>
<p class="p">You can also find your subdomain on Admin Home.</p>
<div class="p">
<strong class="ph b">To open Admin Home to view your subdomain</strong><ul class="ul" id="topic_fxc_dmg_y3c__ul_lyv_zng_y3c">
<li class="li">Click the Zendesk Products <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408838272410" target="_blank">menu</a> in the top bar, then select
<strong class="ph b">Admin Center</strong>.</li>
</ul>
</div>
<p class="p">See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_whk_vpj_fcc" target="_blank">Viewing account information on Admin Center
Home</a>. </p>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_vcg_jvs_nvb">
<h2 class="title topictitle2" id="ariaid-title3">Important considerations before renaming your subdomain</h2>
<div class="body">
<p class="p">Before you rename your subdomain, consider simply changing your <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408842817434#topic_j34_xj2_4nb" target="_blank">account name</a> or setting up <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408838571930" target="_blank">host mapping</a> as alternatives instead.</p>
<p class="p">Host mapping (purchasing another domain that points to your Zendesk) is highly
recommended as an alternative to renaming 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. See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408838571930" target="_blank">Changing the URL of your help center</a>.</p>
<div class="p">If you want to proceed with renaming your subdomain, make sure you understand the
following important considerations:<ul class="ul" id="topic_vcg_jvs_nvb__ul_qpc_bws_nvb">
<li class="li">Renaming your subdomain takes effect immediately, so it’s recommended to
make the change during low-volume hours or after your business hours because
some functionality is affected.</li>
<li class="li">Renaming your subdomain changes the URL of your help center (for example,
<em class="ph i">myoldsubdomain.</em>zendesk.com/hc to
<em class="ph i">mynewsubdomain.</em>zendesk.com/hc). You may need to update links or
bookmarks referencing the old help center URL to ensure users can access the
correct site. Additionally, you should communicate this change to your
customers to avoid confusion.</li>
<li class="li">If you rename your Zendesk subdomain, any Zendesk support email addresses
that are based on your old subdomain will automatically update to reflect
your new subdomain. For example, if your previous subdomain was
<em class="ph i">myoldsubdomain</em> and you renamed it to <em class="ph i">mynewsubdomain</em>, any
support addresses like support@<em class="ph i">myoldsubdomain</em>.zendesk.com would
change to support@<em class="ph i">mynewsubdomain</em>.zendesk.com.</li>
<li class="li">There may be a delay of several hours before you can add new native support
addresses. When <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408842868506#topic_wg1_1zk_zm" target="_blank">adding a support address</a>, check
that the new subdomain appears on the "Create a new support address" form.
If the old subdomain appears, check back again in a few hours.</li>
<li class="li">Chat may be inaccessible for up to 2 hours after changing your subdomain. We
highly recommend you change your subdomain after hours.</li>
<li class="li">If you use Sunshine Conversations through the Agent Workspace and want to
change your subdomain, you must delete and then recreate your Sunshine
Conversations integrations. We recommend using <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408838571930" target="_blank">host-mapped domains</a> instead of
changing a subdomain. Note that changing your subdomain will halt all
Zendesk bot and autoreply activity. If you want to continue your Zendesk bot
activity, don't change your subdomain.</li>
<li class="li">Customers using the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/7189260823194" target="_blank">Authenticated SMTP Connector</a> will
need to deprecate their usage before renaming their subdomain, then re-add
their configuration once the subdomain change is complete, as this feature
is subdomain-specific and will not automatically
update.</li>
<li class="li">Access to many early access programs (EAPs) is controlled by the account
subdomain. If you change your subdomain, you will lose access to any EAPs
controlled in this manner. You must sign up again for those EAPs with your
new subdomain.</li>
<li class="li">After you change your domain, you cannot copy and paste comments (internal
or public) or images from a ticket created in the old domain. Doing so
results in broken images and incomplete comments. You must recreate comments
or re-upload the image attachments directly into the ticket in the new
domain.</li>
</ul>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_ahm_lws_nvb">
<h2 class="title topictitle2" id="ariaid-title4">Step 1: Tasks before renaming your subdomain</h2>
<div class="body">
<p class="p">Before renaming your subdomain, you should update the following items:</p>
<ul class="ul" id="topic_ahm_lws_nvb__ul_iqh_qws_nvb">
<li class="li"><a class="xref" href="#topic_plc_2cw_c1c">Email forwarding from external
addresses</a></li>
<li class="li"><a class="xref" href="#topic_vfx_sws_nvb">CNAME, host maps, and
SSL</a></li>
<li class="li"><a class="xref" href="#topic_u1m_cxs_nvb">Jira integration</a></li>
<li class="li"><a class="xref" href="#topic_t3q_nwz_c3c">Salesforce integration</a></li>
</ul>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested2" id="topic_plc_2cw_c1c">
<h3 class="title topictitle3" id="ariaid-title5">Email forwarding from external addresses</h3>
<div class="body">
<p class="p">You need to update any <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886828698-Using-an-external-email-domain" target="_blank">email forwarding</a> 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 <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5318946039578" target="_blank">Accepting wildcard email addresses for
support requests</a>). You should "flip the switch" during a slow period
to be sure you have time to get everything in order.</p>
<p class="p">Things to consider:</p>
<ul class="ul" id="topic_plc_2cw_c1c__ul_ign_lcw_c1c">
<li class="li">You are responsible for migrating external addresses. Zendesk cannot migrate
external addresses automatically.</li>
<li class="li">Ensure all your external addresses route to the new subdomain, and remove
all routing rules for the old subdomain.</li>
<li class="li">If you forward email from multiple external addresses to multiple Zendesk
addresses, you must temporarily consolidate email traffic under your default
support address (support@<em class="ph i">new_subdomain</em>.zendesk.com) or enable
wildcards. Although it may take several hours before you can add new native
support addresses using the new domain, the default
support@<em class="ph i">new_subdomain</em>.zendesk.com address is available right
away.</li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title6" class="topic nested2" id="topic_vfx_sws_nvb">
<h3 class="title topictitle3" id="ariaid-title6">CNAME, host maps, and SSL</h3>
<div class="body">
<p class="p">Update any <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408838571930-Changing-the-address-of-your-support-website-on-Zendesk-host-mapping-" target="_blank">host mapping</a> to point to your new
support address and URL. Ensure that any CNAME changes and certificate updates
are done with your customer service team before changing your subdomain. You
must 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. </p>
<p class="p">You can obtain a new SSL certificate by grabbing a Certificate Signing Request
and then uploading the new certificate to Zendesk Support. You must install a
new SSL certificate that covers the changed host mapped URL. For more
information, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408838571930#topic_tmg_zqk_j4b" target="_blank">Replacing a certificate</a>. </p>
</div>
</div>
<div aria-labelledby="ariaid-title7" class="topic nested2" id="topic_u1m_cxs_nvb">
<h3 class="title topictitle3" id="ariaid-title7">Jira integration</h3>
<div class="body">
<p class="p">If you've connected the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408837969946" target="_blank">Jira integration</a>, update your Jira
settings before changing your subdomain.
</p>
<div class="p">
<strong class="ph b">To update Jira with a new subdomain</strong><ol class="ol" id="topic_u1m_cxs_nvb__ol_jtn_3xs_nvb">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_u1m_cxs_nvb__image_rbv_4jc_ksb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png">
<strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">Apps &gt; Channel
apps</strong>.</span></li>
<li class="li">Disable the Jira app.</li>
<li class="li">Rename your subdomain.</li>
<li class="li">Enable the connector again in Jira.</li>
<li class="li">Select the <strong class="ph b">Configure </strong>option in the connector setup.</li>
<li class="li">On the next screen, click on <strong class="ph b">Complete set-up</strong> to install the
App.</li>
<li class="li">Follow the on-screen instructions.</li>
<li class="li">Go back to Zendesk Support and check to see if the Jira app loads
properly.</li>
</ol>
</div>
<p class="p">Your linked tickets/issues with Zendesk Support and Jira will not be lost in this
process; we're just re-authorizing the Zendesk app.</p>
<p class="p">You might have to update your other apps as well if you used OAuth credentials
tied to your old subdomain.</p>
</div>
</div>
<div aria-labelledby="ariaid-title8" class="topic nested2" id="topic_t3q_nwz_c3c">
<h3 class="title topictitle3" id="ariaid-title8">Salesforce integration</h3>
<div class="body">
<p class="p"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408821555482#topic_rmq_jkt_sjb" target="_blank">Disconnect the Salesforce integration</a>
before renaming your subdomain.</p>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title9" class="topic nested1" id="topic_ffp_rrv_3kc">
<h2 class="title topictitle2" id="ariaid-title9">Step 2: Rename your subdomain</h2>
<div class="body">
<p class="p">You must be the account owner to rename a subdomain. If you aren't the account owner,
you can <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408822084634#topic_xkh_3lm_ygb" target="_blank">find the account owner</a> and request that
they make the change.</p>
<p class="p">Zendesk can't change your account's subdomain for you. If you can't find the account
owner, work with your IT administrators. If you can’t resolve this, contact <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408843597850" target="_blank">Zendesk Customer Support</a> to initiate a security
review.</p>
<p class="p">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 sign in again to your new Zendesk location, their profiles and ticket
histories will still be intact.</p>
<p class="p">Be sure to complete the tasks in <a class="xref" href="#topic_gwv_qpt_nvb">Step 3: Tasks after renaming your subdomain</a>
after you change your subdomain.</p>
<div class="note" id="topic_ffp_rrv_3kc__note_ntn_vrv_3kc">
<span class="notetitle">Note:</span> When you rename your subdomain, you must choose a name that
contains between 3 and 63 characters. You can't use underscores (_) or other special
characters as part of the name. It can include only letters A-Z, numbers 0-9, and
dashes (-).</div>
<p class="p"><strong class="ph b">To rename a subdomain</strong></p>
<ol class="ol" id="topic_ffp_rrv_3kc__ol_otn_vrv_3kc">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_ffp_rrv_3kc__image_vnr_vfc_ksb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_account_icon.png">
<strong class="ph b">Account</strong> in the sidebar, then select <strong class="ph b">Appearance &gt; Branding</strong>.</span></li>
<li class="li">In the Subdomain field, click <strong class="ph b">Change your subdomain</strong>.</li>
<li class="li">Enter a new name for your subdomain. </li>
<li class="li">Review the consequences of changing your subdomain, then click <strong class="ph b">Rename
subdomain</strong>.<p class="p"><img class="image img-screenshot" id="topic_ffp_rrv_3kc__image_ptn_vrv_3kc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_account_rename_subdomain.png" width="400"></p>
</li>
</ol>
<div class="note" id="topic_ffp_rrv_3kc__note_qtn_vrv_3kc">
<span class="notetitle">Note:</span> If you have multiple brands activated in your account, you
change the brand subdomain from the <strong class="ph b">Account &gt; Brand management &gt; Brands</strong> page
in Admin Center. Select a brand, then select <strong class="ph b">Edit</strong> from the options menu
(<img class="image" id="topic_ffp_rrv_3kc__image_rtn_vrv_3kc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/icon_options_menu.png">).</div>
</div>
</div>
<div aria-labelledby="ariaid-title10" class="topic nested1" id="topic_gwv_qpt_nvb">
<h2 class="title topictitle2" id="ariaid-title10">Step 3: Tasks after renaming your subdomain</h2>
<div class="body">
<p class="p">After renaming your subdomain, you should update the following items:</p>
<ul class="ul" id="topic_gwv_qpt_nvb__ul_irv_p5t_nvb">
<li class="li"><a class="xref" href="#topic_d5b_cvt_nvb">Ticket sharing
agreements</a></li>
<li class="li"><a class="xref" href="#topic_cnb_jvt_nvb">CSAT representation/ Web Widget
(Classic)</a></li>
<li class="li"><a class="xref" href="#topic_htt_vwt_nvb">Ticket replies</a></li>
<li class="li"><a class="xref" href="#topic_jbs_kxt_nvb">Mobile SDK</a></li>
<li class="li"><a class="xref" href="#topic_xvy_sxt_nvb">Voice</a></li>
<li class="li"><a class="xref" href="#topic_wc4_vxt_nvb">API tokens/credentials</a></li>
<li class="li"><a class="xref" href="#topic_qjq_1yt_nvb">Single sign-on</a></li>
<li class="li"><a class="xref" href="#topic_o2x_ksl_k1c">Messaging</a></li>
<li class="li"><a class="xref" href="#topic_kpb_2yt_nvb">Chat</a></li>
<li class="li"><a class="xref" href="#topic_mcb_xjq_1cc">Workforce manangement</a></li>
<li class="li"><a class="xref" href="#topic_k5l_3yt_nvb">Status notifications</a></li>
<li class="li"><a class="xref" href="#topic_tdq_kyt_nvb">Reporting</a></li>
<li class="li"><a class="xref" href="#topic_abz_vwz_c3c">Salesforce integration</a></li>
</ul>
</div>
<div aria-labelledby="ariaid-title11" class="topic nested2" id="topic_d5b_cvt_nvb">
<h3 class="title topictitle3" id="ariaid-title11">Ticket sharing agreements</h3>
<div class="body">
<p class="p">If you have any active <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408893967514-Sharing-tickets-with-other-Zendesk-accounts" target="_blank">ticket sharing agreements</a>, 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.</p>
<p class="p">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.</p>
</div>
</div>
<div aria-labelledby="ariaid-title12" class="topic nested2" id="topic_cnb_jvt_nvb">
<h3 class="title topictitle3" id="ariaid-title12">CSAT representation/ Web Widget (Classic)</h3>
<div class="body">
<p class="p">If you are using one or more instances of <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408836216218" target="_blank">Web Widget (Classic)</a>, you must 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 <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408894103706" target="_blank">Displaying your last 100 satisfaction
ratings</a>.</p>
<p class="p">You must update your widgets for your help center and website individually after
you have changed your subdomain name.</p>
<div class="p">
<strong class="ph b">To update Web Widget (Classic):</strong><ol class="ol" id="topic_cnb_jvt_nvb__ol_yzk_yvt_nvb">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_cnb_jvt_nvb__image_ajx_m3c_ksb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_channels_icon.png">
<strong class="ph b">Channels</strong> in the sidebar, then select <strong class="ph b">Classic &gt; Web Widget</strong>.</span></li>
<li class="li">Click the <strong class="ph b">Setup tab</strong>, if it is not already selected.</li>
<li class="li">Under the code box, click <strong class="ph b">Copy to clipboard</strong>.<p class="p"><img class="image img-screenshot" id="topic_cnb_jvt_nvb__image_z4s_2wt_nvb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/widget_admin_copy_to_clipboard.png" width="500"></p>
</li>
<li class="li">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
&lt;/HEAD&gt; tag. You need to add the code to every webpage where you
want to update the widget.</li>
</ol>
</div>
<div class="p">
<strong class="ph b">To update your help center widget:</strong><ol class="ol" id="topic_cnb_jvt_nvb__ol_whl_4wt_nvb">
<li class="li">In help center, click <strong class="ph b">Customize design</strong> in the tools panel, then
click <strong class="ph b">edit them</strong>.</li>
<li class="li">Select the <strong class="ph b">Header</strong> template from the drop-down.</li>
<li class="li">Delete any existing help center widget code you have.</li>
<li class="li">Paste the updated code before the &lt;/HEADER&gt; ; tag.</li>
<li class="li">Click <strong class="ph b">save</strong>, then click <strong class="ph b">Publish changes</strong>.</li>
</ol>
</div>
<p class="p">For more information on updating your widgets see, <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408836216218#topic_pp3_pgd_bq" target="_blank">Using Web Widget (Classic) to embed customer
service in your website</a>.</p>
</div>
</div>
<div aria-labelledby="ariaid-title13" class="topic nested2" id="topic_htt_vwt_nvb">
<h3 class="title topictitle3" id="ariaid-title13">Ticket replies</h3>
<div class="body">
<p class="p">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, update all of
these with a public comment after changing your subdomain.</p>
<p class="p">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.</p>
<p class="p"><img class="image img-screenshot" id="topic_htt_vwt_nvb__image_xqc_bxt_nvb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/subdomain1.png" width="600"></p>
<p class="p">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.</p>
<div class="note">
<span class="notetitle">Note:</span> You cannot open attachments or view inline images in tickets that existed
before the subdomain rename. Contact <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408843597850" target="_blank">Zendesk Customer Support</a> to have
inline images fixed. Image links copied and pasted from other sources cannot be
fixed. Attachments cannot be retrieved.</div>
</div>
</div>
<div aria-labelledby="ariaid-title14" class="topic nested2" id="topic_jbs_kxt_nvb">
<h3 class="title topictitle3" id="ariaid-title14">Mobile SDK</h3>
<div class="body">
<p class="p">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.</p>
<div class="p">
<strong class="ph b">To update your Mobile SDK:</strong><ol class="ol" id="topic_jbs_kxt_nvb__ol_cwv_4xt_nvb">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_jbs_kxt_nvb__image_zlm_n3c_ksb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_channels_icon.png">
<strong class="ph b">Channels</strong> in the sidebar, then select <strong class="ph b">Classic &gt; Mobile SDK</strong>.</span></li>
<li class="li">Locate the code snippet with your subdomain in your Android and iOS
code.</li>
<li class="li">Give your developer the updated code snippets.</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title15" class="topic nested2" id="topic_xvy_sxt_nvb">
<h3 class="title topictitle3" id="ariaid-title15">Voice</h3>
<div class="body">
<p class="p">If you experience issues with voice support talk after changing your subdomain,
contact <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408843597850" target="_blank">Zendesk Customer Support</a>.</p>
</div>
</div>
<div aria-labelledby="ariaid-title16" class="topic nested2" id="topic_wc4_vxt_nvb">
<h3 class="title topictitle3" id="ariaid-title16">API authentication</h3>
<div class="body">
<p class="p">If you are using <a class="xref" href="https://developer.zendesk.com/api-reference/introduction/introduction/" target="_blank">Zendesk API</a> 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.</p>
<p class="p">Example:</p>
<div class="p">
<pre class="pre codeblock"><code>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}
</code></pre>
</div>
<p class="p">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 <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408889192858" target="_blank">Managing access to the Zendesk
API</a>.</p>
</div>
</div>
<div aria-labelledby="ariaid-title17" class="topic nested2" id="topic_qjq_1yt_nvb">
<h3 class="title topictitle3" id="ariaid-title17">Single sign-on</h3>
<div class="body">
<p class="p">Both SAML and JWT pass the SSO request to Zendesk Access Consumer URL, which
references your account subdomain. You cannot sign in via SSO until you update
the subdomain.</p>
<p class="p">For information on setting up SSO, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408887505690" target="_blank">Using SAML for single sign-on</a> and
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408845838874-Setting-up-single-sign-on-with-JWT-JSON-Web-Token-" target="_blank">Setting up single sign-on with JWT (JSON Web
Token)</a>.</p>
</div>
</div>
<div aria-labelledby="ariaid-title18" class="topic nested2" id="topic_o2x_ksl_k1c">
<h3 class="title topictitle3" id="ariaid-title18">Messaging</h3>
<div class="body">
<p class="p">When you change your subdomain, a new messaging Web Widget script is generated.
You must update all pages of your site/application to use the new script.
See<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4500748175258#topic_fqh_qtc_3rb" target="_blank"> Installing the Web Widget on a
website</a>.</p>
</div>
</div>
<div aria-labelledby="ariaid-title19" class="topic nested2" id="topic_kpb_2yt_nvb">
<h3 class="title topictitle3" id="ariaid-title19">Chat</h3>
<div class="body">
<p class="p">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.</p>
<p class="p">If you purchased Zendesk Chat and Zendesk Support together, updates occur
automatically, and no action is required.</p>
</div>
</div>
<div aria-labelledby="ariaid-title20" class="topic nested2" id="topic_mcb_xjq_1cc">
<h3 class="title topictitle3" id="ariaid-title20">Workforce management (WFM)</h3>
<div class="body">
<p class="p">When you rename your Zendesk subdomain, rename your subdomain on Zendesk WFM to
ensure the accounts match and your historical data and settings are intact.</p>
<div class="note warning">
<span class="warningtitle">Warning:</span> If you have renamed the subdomain on the Zendesk side, and you
have not updated it on Zendesk WFM yet, the app on the top right of Zendesk
displays a Complete installation message. Do not continue with the new
installation, as it will create a new Zendesk WFM account.</div>
<p class="p"><strong class="ph b">To rename your Zendesk WFM subdomain</strong></p>
<ol class="ol" id="topic_mcb_xjq_1cc__ol_mm3_3kq_1cc">
<li class="li">Once you have renamed your Zendesk subdomain, contact <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408843597850" target="_blank">Zendesk Customer Support</a> with your
previous Zendesk subdomain and your new renamed subdomain. </li>
<li class="li">Zendesk will update your subdomain and invite you to reauthorize the
account.</li>
</ol>
</div>
</div>
<div aria-labelledby="ariaid-title21" class="topic nested2" id="topic_k5l_3yt_nvb">
<h3 class="title topictitle3" id="ariaid-title21">Status notifications</h3>
<div class="body">
<p class="p">If you <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408821424666" target="_blank">subscribed</a> to Zendesk status
notifications, update your subscription with your new subdomain.</p>
</div>
</div>
<div aria-labelledby="ariaid-title22" class="topic nested2" id="topic_tdq_kyt_nvb">
<h3 class="title topictitle3" id="ariaid-title22">Reporting</h3>
<div class="body">
<p class="p">You may see some delayed (or missed) <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408843602714" target="_blank">scheduled dashboard deliveries</a> while
your account re-synchronizes with Explore. </p>
</div>
</div>
<div aria-labelledby="ariaid-title23" class="topic nested2" id="topic_abz_vwz_c3c">
<h3 class="title topictitle3" id="ariaid-title23">Salesforce integration</h3>
<div class="body">
<p class="p">Reconnect the Salesforce integration. See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408821555482#topic_vmn_vkc_rlb" target="_blank">Connecting Salesforce to Zendesk</a>.</p>
</div>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408845973914",
"url": "https://support.zendesk.com/hc/en-us/articles/4408845973914",
"headline": "Renaming your subdomain",
"description": "You can rename your account subdomain to change your URL, but must consider important updates and tasks before and after the change to maintain functionality and access.",
"articleSection": "Account administration",
"datePublished": "2021-10-16T05:17:07+00:00",
"dateModified": "2026-08-24T17:51:39.104987+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408845973914"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
}
}</script><script id="ai-summary-script">
//<![CDATA[
const ai_summary_style = document.createElement('style');
ai_summary_style.innerHTML = `#styled-article-body{padding:0 0 0}#article-body #docs-ai-summary{background-color:#f3f3f3;border:1px solid #d3d3d3;padding:10px 10px 6px;margin-bottom:16px}#article-body #docs-ai-summary #docs-ai-summary-toggle{font-size:.9em;font-weight:700;margin-bottom:4px;cursor:pointer;display:flex;justify-content:space-between;align-items:center}#article-body #docs-ai-summary #docs-ai-summary-toggle #up-triangle{margin-left:auto;padding-right:10px;display:none}#article-body #docs-ai-summary #docs-ai-summary-toggle #down-triangle{margin-left:auto;padding-right:10px}#article-body #docs-ai-summary #docs-ai-summary-content{font-size:.9em;padding-left:25px;padding-right:25px;margin-bottom:12px}`;
document.head.appendChild(ai_summary_style);

const toggleAISummary = () => {
const summary = document.getElementById("docs-ai-summary-content");
const upTriangle = document.getElementById("up-triangle");
const downTriangle = document.getElementById("down-triangle");
if (summary.style.display === "none") {
summary.style.display = "block";
upTriangle.style.display = "none";
downTriangle.style.display = "inline";
} else {
summary.style.display = "none";
upTriangle.style.display = "inline";
downTriangle.style.display = "none";
}
};

document.getElementById("docs-ai-summary-toggle").addEventListener("click", toggleAISummary);
//]]>
</script>
</body>