34.1 Purpose of Allowed Origins

Allowed origins control which website origins are trusted to initialize an Agent's public Chat widget.

This is an important deployment boundary because the widget JavaScript itself is public, while the Agent should run only from websites you authorize.

34.2 Opening Allowed Origins

  1. Open the Agent.
  2. Select Settings.
  3. Locate the Allowed origins card.

The interface explains that the public widget script should be restricted to trusted domains and that every origin must include its scheme and host.

34.3 Required Format

Enter one origin per line. Examples:

  • https://example.com
  • https://app.example.com

Include the protocol, such as https://. Do not enter only a bare domain when the form expects an origin.

34.4 Strict Matching

Allowed Origin matching is strict. Subdomains are not automatically inferred.

For example:

  • https://example.com allows that exact origin.
  • It does not automatically permit https://app.example.com.

If both origins should run the widget, enter both separately.

34.5 Adding Multiple Origins

Place each trusted origin on a separate line. This is useful when the same Agent runs on a main website and one or more approved subdomains.

34.6 Saving Origins

After entering the trusted origins, select Save origins.

The Settings page displays a saved indicator after a successful update and reports how many origins are currently configured.

34.7 Production Safety

Before installing the Chat widget on real customer traffic, confirm that every intended production origin is listed and that unintended domains are not included.

A broad or incorrect origin policy can undermine the purpose of the restriction.

34.8 Development Sites

If testing from a separate development host or localhost origin, that origin must be authorized according to the same origin rules. Remove temporary development access when it is no longer required.

34.9 Allowed Origins vs. Restricted Paths

Allowed Origins answer the question: Which website origin may run this Agent?

Restricted Paths answer a different question: Which paths inside an already allowed origin should not display the widget?

34.10 Troubleshooting a Widget That Does Not Load

If the widget is installed but fails to initialize, compare the browser's actual origin with the Agent's Allowed Origins. Pay particular attention to:

  • HTTP versus HTTPS.
  • Main domain versus subdomain.
  • Different development ports.
  • Misspelled hosts.
Write Your Comment