Configure origins allowlist for knowledge articles

You can configure an origins allowlist to ensure that knowledge authors add only safe links to their knowledge articles.

Important

The supported origins are HTTP or HTTPS protocol, IP address or domain name, and TCP port number. For example, https://www.contoso.com, https://www.contoso.com:443 are supported origins. Knowledge authors must use only links with origin links as specified in the supported origins list.

After you've enabled this feature while creating knowledge articles, if knowledge authors add links whose origin links don't match any of the links specified in the origins list, an error message displays for links that are hosted within an iframe. For example, if you add https://www.contoso.com in the origins list, knowledge authors can use https://www.contoso.com/about or https://www.contoso.com/overview. But if they use https://contoso.com/about or https://contoso.com/overview in the articles, the links will be broken and an error message is displayed. Also, in the Content field on the knowledge article form, knowledge authors see the following message: "Update your origins allowlist if any iframe in the article doesn't work or displays error."

For published articles, agents and portal users see an error message in the article for the links that are hosted within an iframe. In such cases, you must update the origins list so that all the existing iframe links continue to work.

Configure origins allowlist

You can configure the origins allowlist in the Customer Service admin center or Customer Service Hub app by performing the following steps:

1. Go to the Settings page.

   Customer Service admin center

   1. In the site map, select Knowledge in Agent experience. The Knowledge page appears.
   2. In the General settings section, select Manage. The General settings page appears.

   Customer Service Hub - Service Management (deprecated)

   Important

   The Service Management area in Customer Service Hub is deprecated. Use the Customer Service admin center app for admin tasks across Customer Service.

   • In the site map, go to Service Management and select Settings in Knowledge Base Management. The Settings page appears.

2. Go to Origins allowlist and add your links to the Add origin links field.

3. Select Add or Enter to add the link to your list.

4. Select Save.

To remove a domain, select Close next to the domain name.

See also

Create and manage knowledge articles
Search knowledge articles
Search the knowledge base on portals