Define the workItem property in the Work scheduler page configuration

task brazil Updated Sep 10, 2026 1 min read work-sched-create-page-properties.md

Add the workItem property to the Work scheduler page configuration to receive the workItem object provided by the work queue.

Before you begin

Important: Starting with the Brazil release, Workforce Optimization for ITSM is being prepared for future deprecation. It will be hidden and no longer installed on new instances but will continue to be supported. For details, see the Deprecation Process [KB0867184] article in the Now Support Knowledge Base.

Role required: workspace_admin or ui_builder_admin

Procedure

In the Page configuration section, select the Config tab.
In the Properties section, select Edit.
In the Edit properties pop-up window, select +Add.
In the Property name field, enter workItem.
From the Type menu, select JSON.
Select Add.
Select Save.

The workItem property is created.
Hover over the workItem property and select the Dynamic data binding icon ([Omitted image "dynamic-data-binding-icon.png"] Alt text: Dynamic data binding icon).
In the workItem field, type @state.workItem.
Click Save.

Here's a demo on how to define the workItem property in the Work scheduler page configuration.

What to do next

Define event mappings for Work scheduler

Parent Topic:Create a Work scheduler card using the Next Experience UI Builder

Previous topic:Create page scripts for Work scheduler

Next topic:Define event mappings for Work scheduler

62 lines · 3.1 KB Wrap lines

---
title: Define the workItem property in the Work scheduler page configuration
description: Add the workItem property to the Work scheduler page configuration to receive the workItem object provided by the work queue.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/it-service-management/workforce-optimization-for-it-service-management/work-sched-create-page-properties.html
release: brazil
product: Workforce Optimization for IT Service Management
classification: workforce-optimization-for-it-service-management
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Create a Work scheduler card using the Next Experience UI Builder, Setting up, Work scheduler, Workforce Optimization for ITSM, IT Service Management]
---

# Define the workItem property in the Work scheduler page configuration

Add the **workItem** property to the Work scheduler page configuration to receive the **workItem** object provided by the work queue.

## Before you begin

**Important:** Starting with the Brazil release, Workforce Optimization for ITSM is being prepared for future deprecation. It will be hidden and no longer installed on new instances but will continue to be supported. For details, see the [Deprecation Process \[KB0867184\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) article in the Now Support Knowledge Base.

Role required: workspace\_admin or ui\_builder\_admin

## Procedure

1. In the **Page configuration** section, select the **Config** tab.

2. In the **Properties** section, select **Edit**.

3. In the **Edit properties** pop-up window, select **+Add**.

4. In the **Property name** field, enter **workItem**.

5. From the **Type** menu, select **JSON**.

6. Select **Add**.

7. Select **Save**.

The **workItem** property is created.

8. Hover over the **workItem** property and select the Dynamic data binding icon \(\[Omitted image "dynamic-data-binding-icon.png"\] Alt text: Dynamic data binding icon\).

9. In the **workItem** field, type **@state.workItem**.

10. Click **Save**.

Here's a demo on how to define the workItem property in the Work scheduler page configuration.

## What to do next

[Define event mappings for Work scheduler](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/workforce-optimization-for-it-service-management/work-sched-event-mapping.md)

**Parent Topic:**[Create a Work scheduler card using the Next Experience UI Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/workforce-optimization-for-it-service-management/create-workscheduler-card-wfo-itsm.md)

**Previous topic:**[Create page scripts for Work scheduler](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/workforce-optimization-for-it-service-management/work-sched-create-page-scripts.md)

**Next topic:**[Define event mappings for Work scheduler](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/workforce-optimization-for-it-service-management/work-sched-event-mapping.md)