Restricting the Chat widget by country or domain

<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="support_with_msg_all">
<table>
<tbody>
<tr>
<td>
<strong>Support with</strong>
</td>
<td>Live chat and messaging Team, Professional, or Enterprise</td>
</tr>
</tbody>
</table>
</div>
</div>
<p>Using the Widget Security settings in the dashboard, you can restrict what countries and domains can load the chat widget.</p>
<div class="note note">
<span class="notetitle">Note:</span> If you use Web Widget (Classic) with Zendesk Support, keep in mind that the blocked countries and allowed domains settings below impact only chat availability and will not affect the Help Center or contact form experience. </div>
<h2 id="blacklist">Adding countries to the Blocked Countries list</h2>
<p><span style="font-weight: 400;">Prevent the widget from loading in certain countries by adding them to the Blocked Countries list, or "blocklist." You might want to use this setting if you live in a locale where there are legal restrictions against doing business with certain other countries. If you don't enable this setting,</span> the widget will load for all visitors regardless of the country they're located in.</p>
<p><strong>To add or remove countries from the Blocked Countries</strong></p>
<ol>
<li>From the Chat dashboard, go to <strong>Settings </strong>&gt; <strong>Widget </strong>&gt; <strong>Widget Security </strong>tab.</li>
<li>Next to <strong>Blocked Countries</strong>, select <strong>On</strong>.</li>
<li>To add a country to the blocklist, select it from the dropdown menu. <br><img alt="" class="img-screenshot" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/chat_block_menu.png" width="850">
</li>
<li>To remove a country from the blocklist, click on its tile.<br><img alt="" class="img-screenshot" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/chat_unblock_country.png" width="850">
</li>
<li>Click <strong>Save Changes</strong>. </li>
</ol>
<h2 id="whitelist">Adding domains to the Allowed Domains list</h2>
<p><span style="font-weight: 400;">Specify the trusted domains you want the widget to load on by adding them to the Allowed Domains list, or "allowlist." Enabling this feature prevents others from taking your widget code snippet and putting it on their own websites.</span><strong><strong> </strong></strong></p>
<p><span style="font-weight: 400;">You can enter an unlimited number of URL paths. It will do an exact match with what was entered.</span><strong><strong> </strong></strong>Entering <em>subdomain.domain.com</em> will mean the widget will only load for that specific subdomain, and not all of <em>domain.com</em>. If you want to support all subdomains, you can use a wildcard (for example, *<em>.domain.com</em>).</p>
<p><strong>To add domains to the Allowed Domains list</strong></p>
<ol>
<li>
<span style="line-height: 1.5;">From the dashboard, go to </span><strong style="line-height: 1.5;">Settings </strong><span style="line-height: 1.5;">&gt; </span><strong style="line-height: 1.5;">Widget </strong><span style="line-height: 1.5;">&gt; </span><strong style="line-height: 1.5;">Widget Security </strong><span style="line-height: 1.5;">tab.</span>
</li>
<li><span style="line-height: 1.5;">Next to <strong>Allowed Domains</strong>, select <strong>On</strong>.</span></li>
<li>Enter the domains you want to allow in the field. To add additional domains, click the <strong>+ </strong>button.<br><img alt="" class="img-screenshot" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/chat_allow_domain.png" width="850">
</li>
<li>Click <strong>Save Changes</strong>.</li>
</ol>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408887520282",
"url": "https://support.zendesk.com/hc/en-us/articles/4408887520282-Restricting-the-Chat-widget-by-country-or-domain",
"headline": "Restricting the Chat widget by country or domain",
"description": "You can restrict the chat widget's availability by blocking specific countries or allowing only certain domains to load the widget through the Widget Security settings in the dashboard.",
"articleSection": "Configuring the Chat widget",
"datePublished": "2021-10-16T16:35:55+00:00",
"dateModified": "2025-09-05T23:23:57+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408887520282"
},
"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>