Tab widget mapping form

Release version: Australia

Updated March 12, 2026

3 minutes to read

Summarize

Summarized using AI

Summary of Tab Widget Mapping Form

The Tab Widget Mapping Form allows ServiceNow customers to effectively manage the visibility and organization of widgets displayed within tabs on employee profile pages. This functionality is vital for tailoring the user experience based on specific roles and access levels.

Show full answer Show less

Key Features

Name: Identifies the widget-mapping record, which can be referenced in widget options.
Application: Select the application to associate the tab with, such as Employee Center Pro.
Active: Option to activate or deactivate the widget on the tab.
Order: Determines the display sequence of widgets on the tab.
Tab: Specifies the unique name for the associated tab.
Accessible by: Defines user visibility options, including roles like Employee or Manager, and criteria for user access.
Allow employee to control visibility: Grants employees the ability to adjust their profile visibility settings if certain access options are chosen.
Widget: Specifies which widget to display on the tab. Visibility settings can be controlled to enhance user experience.
Widget parameters: Enables customization of widget behavior, such as sending notifications or defining calendar views.

Key Outcomes

By utilizing the Tab Widget Mapping Form, ServiceNow customers can:

Customize the visibility of widgets based on user roles, enhancing relevance and user engagement.
Optimize profile page load times by managing the number of associated widgets.
Enable employees to have control over their profile visibility, leading to improved user satisfaction.
Effectively communicate important information through configurable widgets tailored to specific user groups.

Employing these features will streamline the user experience and allow organizations to present relevant information efficiently to their employees.

You can use the tab widget mapping form to display widgets on a tab and control their visibility.

Table 1. Tab widget mapping form
Field	Description
Name	Name of the widget-mapping record that is available in the widgetTitle variable of the widget options object. Use this variable value as the widget title.
Application	Application of the tab. For example, you can select one of the applications such as Employee Center Pro or Employee Center Pro Kiosk.
Active	Option to activate the widget in the tab.
Order	Order number in which you want the widget to appear on the tab.
Tab	Unique name of the tab that you want to associate with.
Accessible by	Users who can view the widgets. Employee only Manager only Employee and manager Everyone Manager and Other Managers Employee, Manager, and Other Managers User criteria: Provide the access only to specific users, groups, and roles with the user criteria. The widget is visible to the users based on the following: Available For: User group for whom the widget is visible. Define and select the user group based on your business needs. Not Available For: User group for whom the widget isn’t visible. Define and select the user group based on your business needs. Values that are defined in the Not Available For group take precedence over the values defined in the Available For group. If both aren't defined, the widget is visible to all users. For more information on widget visibility based on user criteria, see User Criteria output. Note: Use the user criteria cautiously because the profile page load time can take longer based on your criteria. Based on your selection, the profile visibility is either locked or made available for editing by the employee.
Allow employee to control visibility	This field appears only when you select one of the Employee only, Employee and manager, or Everyone options. Note: To view and change the visibility setting, embed the Public Profile Visibility widget inside the configured widget. When you select the value as true, employees can see the edit option used to modify the visibility settings. The modified visibility setting (employee_profile.widget_visibility) is stored in the user preference table. Note: Settings configured in the Allow employee to control visibility field take precedence over the settings configured in the Accessible by field to display the information. Employees can change the admin configuration and determine how much of the profile information is visible to the public. Here’s a sample code for invoking the Public Profile Visibility widget. `data.publicProfileWidget = $sp.getWidget("public_profile_visibility", { tabWidgetMappingId: options.tabWidgetMappingId ? options.tabWidgetMappingId : "", isUserSelectionEnabled: options.isUserSelectionEnabled ? options.isUserSelectionEnabled : "", widgetTitle: options.widgetTitle ? options.widgetTitle : “” });` `To embed it in your widget use the sp-widget directive. For example, <sp-widget widget="data.publicProfileWidget"></sp-widget>` This field value is available in the isUserSelectionEnabled variable of the widget options object.
Widget	Widget to display on the tab. Note: Only when you map a widget to the tab, the information displays inside the tab on the employee profile page. When the widget is visible on the UI, set the isVisible variable value to true in the server script data object to indicate the widget visibility. For example, data.isVisible = true. For optimal tab load time, use a max of seven associated widgets, which can take 250 ms or equivalent. Note: If the widget type is Employee Profile Overview, you can select the set of sections to be displayed under this widget.
Widget parameters	Comma-separated list of widget parameters auto-populated with default values. For the Employee Schedule widget, to send Email or SMS, specify the widget parameters `enable_send_email` and `enable_send_sms` values to true. For more information, see Configure the mail and SMS send to self. For default calendar view, specify `default_calendar_view` value to day or week or month.