Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Associate a domain ID with a chat portal

The Service Portal platform is not domain-separated, but you can create different versions of a portal and restrict each version's use to a single domain for chat purposes. For example, you could create two employee service portals and define a different domain for each.

Before you begin

Role required: admin

About this task

Elements of the Service Portal platform such as settings, portals, pages and widgets are not domain-separated. However, the data within widgets does display when based on the appropriate domain. To provide different experiences, admins should create separate service portals, each with unique URLs, that they can redirect users to. For a domain-separated chat experience in the chat widget channel, create a portal and use the sysparm_domain_id parameter in the URL to designate the domain. For more information, see Virtual Agent URL parameters.

Procedure

  1. Create a new domain and assign roles to the domain as needed.

  2. Copy the domain's sys ID.

    1. Navigate to All > Domain Admin > Domains.

    2. Right-select the name of a domain, and then select Copy sys_id.

Image omitted: copy-domain-sys-id.png
Copy the sys ID for the domain.
3.  Paste the ID in a text editor and save it for later.
  1. Navigate to All > Service Portal > Agent Chat.

  2. Select the name of the portal that you want to restrict to a domain, or create a new one.

    If prompted, open the record for editing.

  3. In the Server script area, add the domain_id parameter and the domain's sys ID that you copied earlier.

Image omitted: add-domain-id-chat-portal.png
Add the domain\_id parameter to the portal script.
  1. Select Update or Submit to save your changes.

Result

The sysparm_domain_id parameter gets passed in the portal URL.

Parent Topic:Domain separation and Virtual Agent