Configure task scope and action widget
Configure the applicable task scope and the actions with a custom AIX action widget. Use this when you need task-specific actions that differ from the standard action group.
Before you begin
Role required: sn_hr_sp.esc_admin or admin
About this task
Configure task scope and a custom AIX action widget to suit your needs for a task type.
- The AIX action widget field accepts a custom widget built for your organization and replaces the action group on both list and detail views.
- The AI insights tab appears only when Applies to is set to All or EmployeeWorks Web App. AI insights apply only to EmployeeWorks Web App. A banner on the tab indicates that this configuration has no effect in Employee Center.
- After an upgrade, existing task configuration records automatically set Applies to to All and clear the Use custom script check box. Your existing AI insights skill configurations continue to work without modification.
Procedure
-
Go to All > Employee Center > Administration > To-dos Configurations, select a to-dos configuration, and open the Task Configuration related list.
-
Open the task configuration for the required record type, such as Request.
-
In the Applies to field, specify the experience that uses this task configuration.
[Omitted image "es-insights-action.png"] Alt text: Task Configuration record with scope selection set to Employee Slate.
Applies to options:
Scope Description All (default) Applies the configuration to both Employee Center and EmployeeWorks Web App. When Use widget is selected on the Primary Info tab, both the Widget field (for Employee Center) and the AIX widget field (for EmployeeWorks Web App) are mandatory, each with its own widget parameters. Employee Center Only the Widget field and Widget parameters appear on the Primary Info tab. The AI insights tab and the EmployeeWorks Web App Card Info tab don't appear, because AI insights apply only to EmployeeWorks Web App. EmployeeWorks Web App Only the AIX widget field (mandatory) and AIX Widget parameters appear on the Primary Info tab. Select the out-of-the-box widget or a custom widget built for your organization. -
Go to the Action tab.
[Omitted image "es-insights-action-group.png"] Alt text: Task Configuration Action tab with Action group set to Approvals action group and AIX action widget set to Custom action.
- Search and select an existing an action group such as
Approvals action group. - Select a custom action widget built for your organization For new task configurations targeting only EmployeeWorks Web App, configure only the AIX Action Widget.
Note: When you don't add a custom action to the AIX action widget, the action group falls back to Employee Center action behavior.
- Search and select an existing an action group such as
-
Save the task configuration.
Result
The custom widget replaces the action group on the task list view and the task detail view.
What to do next
Clear the AIX action widget field to fall back to the Employee Center action group.
Related topics
---
title: Configure task scope and action widget
description: Configure the applicable task scope and the actions with a custom AIX action widget. Use this when you need task-specific actions that differ from the standard action group.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/employee-service-management/employee-experience-foundation/empworks-configure-action-widget.html
release: brazil
product: Employee Experience Foundation
classification: employee-experience-foundation
topic_type: task
last_updated: "2026-07-27"
reading_time_minutes: 3
keywords: [AIX action widget, task configuration, Employee Center action group, Employee Slate, Employee Works]
breadcrumb: [Task configuration, Tasks and requests, Working with EmployeeWorks capabilities, ServiceNow EmployeeWorks Web App, EmployeeWorks, Employee Service Management]
---
# Configure task scope and action widget
Configure the applicable task scope and the actions with a custom AIX action widget. Use this when you need task-specific actions that differ from the standard action group.
## Before you begin
Role required: sn\_hr\_sp.esc\_admin or admin
## About this task
Configure task scope and a custom AIX action widget to suit your needs for a task type.
- The **AIX action widget** field accepts a custom widget built for your organization and replaces the action group on both list and detail views.
- The **AI insights** tab appears only when **Applies to** is set to **All** or EmployeeWorks Web App. AI insights apply only to EmployeeWorks Web App. A banner on the tab indicates that this configuration has no effect in Employee Center.
- After an upgrade, existing task configuration records automatically set **Applies to** to **All** and clear the **Use custom script** check box. Your existing AI insights skill configurations continue to work without modification.
## Procedure
1. Go to **All** > **Employee Center** > **Administration** > **To-dos Configurations**, select a to-dos configuration, and open the **Task Configuration** related list.
2. Open the task configuration for the required record type, such as **Request**.
3. In the **Applies to** field, specify the experience that uses this task configuration.
\[Omitted image "es-insights-action.png"\] Alt text: Task Configuration record with scope selection set to Employee Slate.
Applies to options:
|Scope|Description|
|-----|-----------|
|**All** \(default\)|Applies the configuration to both Employee Center and EmployeeWorks Web App. When **Use widget** is selected on the **Primary Info** tab, both the **Widget** field \(for Employee Center\) and the **AIX widget** field \(for EmployeeWorks Web App\) are mandatory, each with its own widget parameters.|
|Employee Center|Only the **Widget** field and **Widget parameters** appear on the **Primary Info** tab. The **AI insights** tab and the EmployeeWorks Web App **Card Info** tab don't appear, because AI insights apply only to EmployeeWorks Web App.|
|EmployeeWorks Web App|Only the **AIX widget** field \(mandatory\) and **AIX Widget parameters** appear on the **Primary Info** tab. Select the out-of-the-box widget or a custom widget built for your organization.|
4. Go to the **Action** tab.
\[Omitted image "es-insights-action-group.png"\] Alt text: Task Configuration Action tab with Action group set to Approvals action group and AIX action widget set to Custom action.
- Search and select an existing an action group such as `Approvals action group`.
- Select a custom action widget built for your organization
For new task configurations targeting only EmployeeWorks Web App, configure only the AIX Action Widget.
**Note:** When you don't add a custom action to the AIX action widget, the action group falls back to Employee Center action behavior.
5. [Configure a custom AI insights skill for a task type](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/employee-experience-foundation/empworks-configure-ai-insights-skill.md).
6. Save the task configuration.
## Result
The custom widget replaces the action group on the task list view and the task detail view.
## What to do next
Clear the **AIX action widget** field to fall back to the Employee Center action group.
**Related topics**
[Configure action group](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/employee-experience-foundation/update-approval-hub-action-group.md)
[Configure a custom AI insights skill for a task type](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/employee-experience-foundation/empworks-configure-ai-insights-skill.md)
[Manage tasks and approvals](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/employee-experience-foundation/eslate-work-with-inbox.md)
| title | Configure task scope and action widget |
| description | Configure the applicable task scope and the actions with a custom AIX action widget. Use this when you need task-specific actions that differ from the standard action group. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/employee-service-management/employee-experience-foundation/empworks-configure-action-widget.html |
| release | brazil |
| product | Employee Experience Foundation |
| classification | employee-experience-foundation |
| topic_type | task |
| last_updated | 2026-07-27 |
| reading_time_minutes | 3 |
| keywords | AIX action widgettask configurationEmployee Center action groupEmployee SlateEmployee Works |
| breadcrumb | Task configurationTasks and requestsWorking with EmployeeWorks capabilitiesServiceNow EmployeeWorks Web AppEmployeeWorksEmployee Service Management |