Using an allowlist to manage where the Web Widget appears

Verified AI summary ◀▼


Use an allowlist to control where your Web Widget appears by specifying
approved domains. This feature ensures the widget functions only on listed
domains, blocking it elsewhere. You can easily add or remove domains
from the allowlist or disable it entirely to make the widget active on
all sites with the code snippet.




Admins can create an allowlist of website domains to specify where their
Web
Widget can be shown to end users. When you create an allowlist:



The widget can be embedded and accessed on any web pages within the
domains (or subdomains) added to the list.


The widget cannot be accessed on any web pages from domains
not
included in the list.


Admins can quickly block the Web Widget from appearing on a domain
or
subdomain by removing it from the widget’s allowlist.



It’s important to note that the allowlist does not
prevent your Web Widget code
snippet from being added to a website’s code. Rather, it stops the code
snippet from
functioning, blocking the widget on any sites in the domains not included
in the
list.

This article includes the following topics:



Creating an allowlist for the Web Widget


Removing a domain from the
allowlist


Turning off the
allowlist





Creating an allowlist for the Web Widget


You can create an allowlist of website domains to specify where their
Web Widget
can be shown to end users.




To create an allowlist for a widget



In Admin Center, click
Channels in the sidebar, then select Messaging and social >
Messaging.

Click the name of the widget you want to edit.

Scroll down, then click Installation
to expand it.


Click the checkbox to
Only allow Web Widget to be installed
on these domains.





Add the domains or subdomains where the widget
can be
installed. To add all subdomains from a single domain,
add an asterisk
before the domain name (for example,
*.yourdomain.com).

Only alphabetical characters are allowed after the
final dot (.)
in the subdomain. For example,
my-awesome-restaurant.pizza
is valid, but
my-awesome-restaurant.pizza-chain
is
not.



Click Save.






Note: As soon as you save, Web
Widget appears only on web pages in the specified
domains. If you enable the allowlist for a widget that has already
been embedded
in a website, and that website’s domain or subdomain is not included
in the
allowlist, it will be blocked on that website.





Removing a domain from the allowlist


If you no longer wish to allow your Web Widget on a domain or subdomain,
you can remove that domain from the allowlist, which immediately
blocks it from the
removed website.


To remove a domain from the allowlist



In Admin Center, click
Channels in the sidebar, then select Messaging and social >
Messaging.

Click the name of the widget you want to edit.

Scroll down, then click Installation
to expand it.


Under
Only allow Web Widget to be installed on these domains,
remove the domains or subdomains where the widget should be blocked


Click Save.





Turning off the allowlist


If you choose to no longer restrict your Web Widget by domain, you
can turn off the
allowlist on that widget. When you turn off the allowlist, the Web
Widget becomes
active on all websites that have added the Web Widget code snippet
to their page
code.


To turn off the allowlist




In Admin Center, click
Channels in the sidebar, then select Messaging and social >
Messaging.

Click the name of the widget you want to edit.

Scroll down, then click Installation
to expand it.


Deselect the checkbox to
Only allow Web Widget to be installed on these
domains.


Click Save.






//
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);
//