---
sourceDocument: Xanadu Employee Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/employee-service-management

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Employee Service Management

ft:clusterId :

    - emplsm

bundleId :

    - emplsm

workflow :

    - Employee


---

# Add a button to initiate contract

# Add a workspace action button for initiating a contract request {#ariaid-title1}

* Release version: Xanadu
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Define an action button in your workspace and map it to the built-in action that initiates a contract request.

## Before you begin

Role required: admin

## Procedure

1. Add initiate contract request functionality to your workspace.
   1. Navigate to AllNow Experience FrameworkDeclarative ActionsForm Actions  
      For more information, see [Customizing Configurable Workspace with declarative actions](https://www.servicenow.com/docs/access?context=declarative-actions-landing&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
   2. Select New.
   3. Set the action to the type UXF client action and map the action to the initiate contract request functionality and by entering the following field values.  
      {#cncore-config-initiate-cont__table_wjg_xgm_b1b__entry__2}

      | Field | Value |
      |-|-|
      | Implemented as | UFX Client Action |
      | Specify client action | Initiate contract |
      [Table 1. Initiate contract request fields]

      {#cncore-config-initiate-cont__table_wjg_xgm_b1b}
   4. On the form, fill in the other fields.  
      For details, see [Action assignment form](https://www.servicenow.com/docs/p3PeYrJE7a_Ltam1lU8JwA "The action assignment form is used to define a action in your application.")
   5. Right-click the form header and select Save.
   {#cncore-config-initiate-cont__substeps_dfm_4mw_s1c}
2. Create an event mapping for the initiate contract declarative action.
   1. Select Advanced view listed under Related Links.
   2. Select to the UX Add-on Event Mappings related list.
   3. Select New.
   4. In the Source Declarative Action field, select initiate_contract.
   5. In the Target Event field, select \[Record Page\] Open modal.
   6. In the Target Payload Mapping field, define the fields to send by pasting the following JSON code.  

          {
              "container": {
                  "fields": {
                      "binding": {
                          "address": [
                              "fields"
                          ]
                      },
                      "type": "EVENT_PAYLOAD_BINDING"
                  },
                  "params": {
                      "binding": {
                          "address": [
                              "params"
                          ]
                      },
                      "type": "EVENT_PAYLOAD_BINDING"
                  },
                  "route": {
                      "binding": {
                          "address": [
                              "route"
                          ]
                      },
                      "type": "EVENT_PAYLOAD_BINDING"
                  }
              },
              "type": "MAP_CONTAINER"
          }

   7. On the form, fill in the other fields.  

      For a description of the field values, see [UFX Add on Event mapping form](https://www.servicenow.com/docs/WAwJZ5LijTBoONzsP6sZYw "The UFX Add on Event mapping form to configure the display of declarative action in your application.").
   8. Select Submit.
   {#cncore-config-initiate-cont__substeps_twd_zmw_s1c}
3. **Optional:** Configure visibility conditions for initiate contract action button.
   1. Select Advanced view listed under Related Links.
   2. Select to the Conditions related list.
   3. Set the conditions for the visibility of the action button.
   {#cncore-config-initiate-cont__substeps_jyt_zwd_5fc}
{#cncore-config-initiate-cont__steps_gtk_klq_vyb}

## Result

An action button to initiate contract requests from a contract record is available in your workspace.
Figure 1. Initiate contract action configured

*[\>]: and then