---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Define the workItem property in the Work scheduler page configuration

# Define the workItem property in the Work scheduler page
configuration {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

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

## Before you begin

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 (![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://www.servicenow.com/docs/IyYXMWe9dn6IeOcBjq1P7Q "Add event mappings required for card interactions and for the card properties transformation to the page configurations in Work scheduler.")
**Previous topic:** [Create page scripts for Work scheduler](https://www.servicenow.com/docs/9lg14MTfVBkf9HMsRyPWPg "Add custom page scripts for the Work scheduler so that you can update the client state through events or update transform workItem object to properties.")  
**Next topic:** [Define event mappings for Work scheduler](https://www.servicenow.com/docs/IyYXMWe9dn6IeOcBjq1P7Q "Add event mappings required for card interactions and for the card properties transformation to the page configurations in Work scheduler.")