Setting Up Zoho Contracts Extension in Zoho CRM
Connect an Organization
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Choose the organization from the Organization dropdown, then click Connect.
Disconnect an Organization
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click the Connection tab, then click Disconnect.
Upon disconnection, you will no longer be able to request contracts from Zoho CRM or manage any existing contracts belonging to the disconnected organization.
Enable Modules
The Modules tab in Zoho CRM enables you to select the CRM modules from which you can initiate and manage contracts. You can select from existing modules like Contacts, Accounts, Deals, or Vendors to enable contract requests. You should also choose the contract types in which the contracts can be requested for each of these modules.
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click the Modules tab, then toggle the slider of the respective CRM module that you want to enable it.
- Choose the contract types in the Enable Accounts Module popup window for which you want to allow contract requests, then click Enable.
- Click Save.
Enable Custom Modules
If you have custom modules in Zoho CRM that are specific to your business needs, you can add them in the Modules tab. This way, you can request contracts directly from the records of those custom modules.
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click Add Custom Module in the Modules tab, then select the module in the Custom Module dropdown, and click Add.
- Toggle the slider to enable the custom module and select the contract types for which you want to allow contract requests.
- Click Enable.

Feature Availability: Enterprise and above plans.

Note:
- If a predefined module is disabled in Zoho CRM, it will also be disabled in the extension settings. To enable the module in the extension settings, make sure to enable it in Zoho CRM settings.
- To request contracts from the records in the custom module, you need to add a custom Request Contract button for this module. Furthermore, to view the requested contracts on the details page, you must add a Zoho Contracts Related List to the module.
- Go to Setup → Customization → Modules and Fields.
- Select the Purchases module from the Modules tab.
- Select the Buttons tab.
- Click Create New Button.
- Enter the button name as Request Contract.
- Select layouts in which you want the button to be displayed.
- Choose In Record as the page to place the button.
- Choose Details as the position of the button in the selected page.
- Choose Invoke a URL as the action to perform.
- Copy and paste the below URL in the URL field under Construct Your URL.
https://extensions.zoho.com/plugin/zcrmcontracts/contracts?module=Purchases&rec_id=${Purchases.PurchaseId}&crmzgid=${Organization.Organization Id} - Choose New Window as the target of the button action.
- Choose user profiles to whom the button should be shown.
- Click Save.
The button will be added to the Details Page of a particular record of the custom module.
- Click Setup
from the top-right corner. - Click Modules and Fields under the Customization section.
- Click Consultations from the modules list.
- Click the layout to customize from the layouts list.
- Select the Detail View tab at the top.
- Click Add Related List
in the Related List panel on the left. - Select Widgets from the Add Related List window.
- Click Create New Widget.
- Enter Zoho Contracts in the Name field.
- Choose External in the Hosting field.
- Copy and paste the below URL in the Base URL field.
https://extensions.zoho.com/jsp/zcrmcontracts/details.jsp - Click Save. The new widget will be created.
- Click Install next to the created widget.
- Enter Zoho Contracts in the Custom Related List Name field.
- Click Save.
The related list will be added to the Details page of each record in the respective custom module.
The following table explains the Counterparty and Counterparty Type in the Zoho Contracts Settings page. You must choose the counterparty for each module with whom contracts are requested from Zoho CRM and their type maintained in Zoho Contracts.
Option | Description |
Counterparty | The name of the record which should be considered as the counterparty with whom your organization is entering into a contract with (e.g. Account). |
Counterparty Type | The type of the counterparty with whom your organization is entering into a contract with (e.g. Customer). |
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click the Counterparty tab, then click the Module for which you need to choose the Counterparty and Counterparty Type.
- Choose the counterparty and counterparty type for each module using the dropdown list.
- Click Save.
For Contacts, Deals, and custom modules, you can choose the counterparty and counterparty type using the Always or Condition-Based option.
To select the Counterparty and Counterparty Type using the Condition-Based option,
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click the module under the Conterparty tab, in which you need to add the counterparty settings.
- Click the Condition-Based option, then select the Counterparty and Counterparty Type from their respective dropdown list.
- Specify which record should be considered as the counterparty by setting rules. E.g., For a B2B (Business to Business) scenario, you can choose the Account Name field because it represents the organization you are contracting with. On the other hand, in a B2C (Business-to-Consumer) scenario, the Contact Name field is more appropriate, as it refers to the individual consumer involved in the contract.
- Click
to add more rules and combine them using logical operators like AND (for all conditions to apply) or OR (for any condition to apply). - Click Add Condition to create more sets of rules for other counterparties or types.
- Click Save.

Note: If more than one condition is satisfied, the contract requester will be asked to choose the correct counterparty when requesting a contract.
The following table explains the counterparty contact fields in the Counterparty Contact Fields Mapping section of the Zoho Contracts - Settings page. You must map these fields with Zoho CRM Contacts module fields to add the contact as a counterparty contact in Zoho Contracts.
Field Name | Description |
Contact Name | The name of the counterparty contact with whom you will have contract-related communications. |
Contact Email Address | The email address of the counterparty contact with whom you will have contract-related communications. |
Based on the field mapping that you configure, the field values of the respective modules in Zoho CRM will be populated automatically in Zoho Contracts during contract requests.
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click the Field Mapping tab, then map the fields under Counterparty Contact Fields by selecting the fields from the Contacts Module Fields dropdown list.
- Click
to save.
Map Contract Document Fields for each Module
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click the Field Mapping tab, then select the module for which you need to map the fields under Module-wise Fields Mapping.
- Map the Counterparty fields by selecting the fields from the Accounts Module Fields dropdown list.
- Map the contract types' template fields by clicking the Map Fields for each contract type.
- Repeat the steps to map the fields for all the modules.
- Click Save.

Note: If you have selected the counterparty based on the Condition-Based option, map the Counterparty Fields by clicking the Map Fields for each condition.
Add Requester Department
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click the Others tab, then choose the requester departments using the dropdown list.
- Click Save.
Assign Contract Owners for Each Contract Type
- Log in to your Zoho CRM account.
- Click Settings
in the top-right corner of the page. - Select Zoho from the Marketplace section, then select Zoho Contracts.
- Click Settings at the top-right corner of the Extension Details page.
- Click the Others tab, then choose the Contract Owner for each contract type under Contract Assignment using the Assign Request To dropdown list.
- Click Save.