--- sourceDocument: Yokohama Employee Service Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/employee-service-management Release : - yokohama ft:locale : - en-US ft:publication_title : - Yokohama Employee Service Management ft:clusterId : - emplsm bundleId : - emplsm workflow : - Employee --- # Tab widget mapping form # Tab widget mapping form {#ariaid-title1} Release version: Yokohama Updated January 30, 2025 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Tab widget mapping form The Tab widget mapping form enables you to display and control the visibility of widgets on specific tabs within the Employee Profile page in ServiceNow. This form helps configure which widgets appear on tabs, their order, and access permissions based on user roles and criteria. Show full answer Show less ## Key Features * **Name:** Defines the widget-mapping record name, used as the widget title in the widget options. * **Application:** Associates the widget with a specific application, such as Employee Center Pro or Employee Center Pro Kiosk. * **Active:** Option to activate or deactivate the widget on the tab. * **Order:** Determines the sequence in which widgets appear on the tab. * **Tab:** Associates the widget with a unique tab name. * **Accessible by:** Controls visibility based on user roles (e.g., Employee only, Manager only, Everyone) or user criteria for specific users, groups, or roles. * **User Criteria:** Allows fine-grained access control using "Available For" and "Not Available For" user groups, with "Not Available For" taking precedence. * **Allow employee to control visibility:** When enabled, employees can edit widget visibility settings via the embedded Public Profile Visibility widget, with preferences stored in the user preference table. * **Widget:** Selects the widget to display on the tab; visibility must be set true in server script for UI display. * **Widget parameters:** Supports configuration of parameters such as enabling email or SMS notifications and setting default calendar views for specific widgets like Employee Schedule. ## Practical Considerations * Limit the number of widgets per tab to a maximum of seven for optimal load performance (approximately 250 ms load time). * Use the `isUserSelectionEnabled` and `widgetTitle` variables in widget options to manage employee-controlled visibility and widget titles. * Embedding the Public Profile Visibility widget allows employees to manage their profile widget visibility settings directly. * Widget visibility respects both admin configurations and user preferences, with user-controlled settings taking precedence. ## Benefits for ServiceNow Customers This form gives administrators precise control over the Employee Profile page layout and content, ensuring that users see relevant widgets based on their roles and permissions. By customizing widget visibility and order, you can enhance user experience and streamline profile information management. Additionally, enabling employees to control visibility empowers them to manage their own profile information securely. You can use the tab widget mapping form to display widgets on a tab and control their visibility. {#tab-widget-mapping-form__id_apm_rzw_mwb__entry__2} | 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. {#tab-widget-mapping-form__ul_oxv_kj5_ywb}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](https://servicenow-prod.fluidtopics.net/qei25LGzZsVj8XVLMg~hxA "User Criteria output based on Available For and Not Available For values."). Note: Use the user criteria cautiously because the profile page load time can take longer based on your criteria. {#tab-widget-mapping-form__ul_xbj_3wj_swb}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, ` 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](https://servicenow-prod.fluidtopics.net/KsHgDAmsMMZs92IAhC3Wug "Help employees access information easily by sending required information as an SMS or email."). For default calendar view, specify `default_calendar_view` value to day or week or month. | [Table 1. Tab widget mapping form] {#tab-widget-mapping-form__id_apm_rzw_mwb} **Related concepts** * [Browser Extension for Employee Center forms](https://servicenow-prod.fluidtopics.net/~2_l4lBN1pQWFT5h_wkPzQ "The Browser Extension for Employee Center forms provide information about various configurations required to set up the extension.") * [Employee Center widgets](https://servicenow-prod.fluidtopics.net/aeObCMqZR1fC_Sxqo_zWRw "You can use base system widgets as-is in the portal or clone them to suit your own business needs.") * [Employee Profile form](https://servicenow-prod.fluidtopics.net/9xxhw0oY3A9VAGP6eNREvg "An option in the Employee Profile configuration that provides a list of employee profile fields.") * [Enhanced Requests Experience forms](https://servicenow-prod.fluidtopics.net/o6uvyiYVt~~wtlW0fKTlRg "The forms provide information to set up the Enhanced Requests Experience.") **Related tasks** * [Manage profile tabs and visibility in Employee Profile](https://servicenow-prod.fluidtopics.net/Z4zP7mMZ_9gDeyU1m4NV1Q "Enable the display of work-related content in the employee profile to help customize the public profile visibility settings.") **Related reference** * [Activity Configuration form](https://servicenow-prod.fluidtopics.net/x7OtyAcBIWNOvy094dQOnQ "Use the Activity Configuration form to do a basic configuration or an advanced configuration for an activity.") * [Activity Configuration Detail form](https://servicenow-prod.fluidtopics.net/6BjWB7BgmPmvkwQxvZ9qgA "Use the Activity Configuration Detail form to specify which records you want to retrieve from a table when certain conditions are met for a basic activity configuration.") * [Connected Content form](https://servicenow-prod.fluidtopics.net/uxFP0X8H5U66nzI5oq8QmA "Use the connected content form to associate content to the topics in your taxonomy.") * [Default Employee Profile Header Configuration record](https://servicenow-prod.fluidtopics.net/fyhiXt2Fd29elKf5z3Erew "The default Employee Profile header configuration record contains the following field values.") * [Employee Profile Header Configuration form](https://servicenow-prod.fluidtopics.net/97_YP21eQHjt5V_AhqbO0Q "Use the Employee Profile Header Configuration form to create a header for a profile.") * [Employee Profile portal configuration form](https://servicenow-prod.fluidtopics.net/A~U17qkrE4Uxa_wJHQ5TZw "Use the Employee Profile Portal Configuration form to configure the profile for a service portal.") * [Employee Profile upgrade scenarios](https://servicenow-prod.fluidtopics.net/MbBfonKH3I7fKl9S_NrI1A "After upgrading Employee Profile to version 11.0.3, the profile pages on all portals are updated based on the following scenarios.") * [External Link form](https://servicenow-prod.fluidtopics.net/q2N1nzTMtlPjUAa04j7~gw "Use the External Link form to create an external link.") * [Featured Content form](https://servicenow-prod.fluidtopics.net/5phHrvccU1fanI0Nvhlkjg "Use the featured content form to mark the associated connected content as featured content for a topic.") * [Footer form](https://servicenow-prod.fluidtopics.net/obPVOM4IEpjD2x5cG_d5CQ "Use the Footer form to create a new footer that you want to appear in the Employee Center or Employee Center Pro.") * [Footer Menus form](https://servicenow-prod.fluidtopics.net/Z4Qzap3nXR3ytpDoIcUMUg "Use the Footer Menus form to create a new footer menu that you want to appear on your Employee Center or Employee Center Pro.") * [Guided Self-Service reference](https://servicenow-prod.fluidtopics.net/~EuWJ4l28Io1iL3ADczrgQ "Use the following reference information for the Guided Self-Service functionality.") * [Menu Item form](https://servicenow-prod.fluidtopics.net/erbwFSmMYdxtJGx_Zo52ww "Use the Menu Items form to configure the items for the More menu on the Employee Center header.") * [Overview section form](https://servicenow-prod.fluidtopics.net/cq95al2U0DQq2LMuSUSfFg "The overview section form enables you to configure a section on the Employee Profile UI.") * [Portal notification configuration form](https://servicenow-prod.fluidtopics.net/eDE0YS7rmFFJGQTPuV~org "The portal notification configurations form enables you to create a unified notification system for your preferred portal.") * [Portal notification content form](https://servicenow-prod.fluidtopics.net/ROhfifu2wCz1p~iT4ttkog "The field descriptions provided here are required to configure your portal notification messages.") * [Quick Link form](https://servicenow-prod.fluidtopics.net/xjXFIwXGmS9DxXqWyV2Thg "Use the Quick Link form to create a new quick link and specify the content type for the quick link.") * [Standard banner and icon sizes](https://servicenow-prod.fluidtopics.net/muWydAAAjNJHc_CBZfQoSw "Use the following sizes for the banner and icons for optimal portal performance.") * [Trigger conditions form](https://servicenow-prod.fluidtopics.net/hpNfQFr~ga8G~tJcHuAWuQ "The field descriptions provided here are essential to create the trigger conditions for your portal notification messages.") * [Taxonomy form](https://servicenow-prod.fluidtopics.net/xDHSMHtmS3lZmdbvfayVQw "Use the taxonomy form to create your own taxonomy for the Employee Center portal.") * [Topic form](https://servicenow-prod.fluidtopics.net/JdNJXdOJBz~uvNipBoqFZw "Use the topic form to create topics for the new or cloned taxonomy.") * [To-do content form](https://servicenow-prod.fluidtopics.net/wbYmNOqxXOvxkv4s_gsfDw "Use the To-do content form to add to-dos to your portal page.") * [User Criteria form](https://servicenow-prod.fluidtopics.net/e9bqFUS_zn1zb6cMKSgsTA "Add a user criteria record to decide which users, roles, and groups can access a quick link.") * [User Criteria output](https://servicenow-prod.fluidtopics.net/qei25LGzZsVj8XVLMg~hxA "User Criteria output based on Available For and Not Available For values.")