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

Embed a custom portal

Embed your custom portal to replace the Employee Center tab in Microsoft Teams by configuring the system property. The custom portal shows up in the Employee Center tab in Microsoft Teams.

Before you begin

Role required: admin

If you’re using a custom portal rather than the Employee Center, you can replace the embedded Employee Center with your custom portal, so that it’s accessible within Microsoft Teams. The following steps take you through the configuration to embed your portal.

Procedure

  1. In the navigation pane, enter sys_properties.list.

  2. Search for sn_now_teams.portal.suffix property under Name.

Image omitted: sys-properties-list.png
System properties list with sn\_now\_teams.portal.suffix highlighted
  1. Select sn_now_teams.portal.suffix.

  2. Enter the value of your custom portal in the Value field.

    Refer to the below example if you are adding your custom portal:

Image omitted: custom-value-sys-properties.png
System property \[sn\_now\_teams.portal.suffix\] form with the value field highlighted.
  1. Select Update.

  2. Create a custom header for the embedded portal after you configure your custom portal.

    For more information on adding header configuration, see Configure HTTP response headers.

    1. In the Navigator pane, type sys_response_header.list.

    2. Select New.

    3. On the HTTP Response Header form, fill in the following fields based on your requirement.

      • Active
      • Application
      • Record
      • Description
        1. Enter the following field values.
FieldValue
Applies toSpecify Type
TypeService Portal \[sp\_portal\]
NameContent-Security-Policy
Value

Frame-ancestors 'self' https://teams.microsoft.comImportant:

To enable the custom portal in all Microsoft 365 apps, add the following domains to the Value field.

  • *.office.com
  • *.office365.com
  • *.microsoft365.com
  • *.cloud.microsoft For example: Frame-ancestors 'self' https://teams.microsoft.com *.office.com *.office365.com *.microsoft365.com *.cloud.microsoft
5.  Select **Submit**.

Parent Topic:Configuring Employee Center