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

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia 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: Australia
* 
* Updated March 12, 2026
* 
* ![](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=australia&pubname=australia-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/wKTKudUZPnfE3MgbjTGYxw "Learn about the fields of the Action Assignment form. Use this form to add the New action button to your workspace.")
   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 UX Add-on Event Mappings related list.
   3. Select New.
   4. In the Source Component field, select Action bar.
   5. In the Source Declarative Action field, select initiate_contract.
   6. In the Controller field, select Form.
   7. In the Target Event field, select \[Record Page\] Open modal.
   8. 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"
          }

   9. 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/gvsivMFRgB4W43svB~o8kw "The UFX Add on Event mapping form to configure the display of declarative action in your application.").
   10. 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
**Related concepts**   

* [Configuring the Playbook tab on contract repository records](https://www.servicenow.com/docs/3gQgqBNuzgdw6od7_8avbA "Configure the visibility of the Playbook tab on contract repository records so contract managers can review and act on AI‑extracted metadata and obligations.")  
**Related tasks**   

* [Configure non-task tables for contract templates](https://www.servicenow.com/docs/~gHcoA2uDDyFCNJha9by0w "Add non-task tables in the script of an extension point implementation so you can select them while creating contract templates. A non-task table does not extend task tables, and stores records, reference data, or configuration information used across the platform.")
* [Add Contract requests tab to the contract request record](https://www.servicenow.com/docs/g8ZgYwi7OvyQKH2VDH8d1Q "As an administrator, add the ability to access contract request details to your form by adding the Contract requests tab.")
* [Add amendment tabs to contract repository record](https://www.servicenow.com/docs/cmwr65GDOKmXo~EzMjBgEg "To view the details of the contract amendment, add the amendment related tabs to the contract repository record.")
* [Add Contract documents tab to the contract repository record](https://www.servicenow.com/docs/~4~xCfJOijDgdWj~f8MDUQ "Enable display of contract documents in a contract repository record by adding the Contract documents tab to it.")
* [Copy fields from parent request to contract request](https://www.servicenow.com/docs/nClxrmn~aWmnF3UrTKHasA "Configure the ContractManagementExt extension point to automatically copy required fields from the parent record to the contract request when it is initiated.")
* [Group contract documents by contract type in a contract request](https://www.servicenow.com/docs/aOGskE9H0ySY5kkYbZ7MZw "As an administrator, group the contract documents by contract type in a contract request.")
* [Add access to obligation management from contract repository records](https://www.servicenow.com/docs/pYvYDQcT5ixBMBkzFRq2Yw "As an administrator, add the Obligations tab in contract repository records to manage contract obligations.")
* [Configure the contract request form header for your workspace](https://www.servicenow.com/docs/_aTM6GOCBD7TdDwV2zUIfA "As an administrator, configure the header of the contract request form for your workspace.")
* [Assign a role for configuring template mappings](https://www.servicenow.com/docs/poirZioo67uApAhpzeKHPQ "Enable a contract user to configure information placed in the contract document by assigning a contract configurator role.")
* [Enable contract request fields in condition builders](https://www.servicenow.com/docs/xLBJ8z3_exa8_CRKNJOGUA "As an administrator, provide access to contract request fields so they can be selected in condition builders.")

*[\>]: and then