ClauseCatgConfiguration Metadata Type Guide

Architectural Overview#

In Salesforce Contracts Lifecycle Management (CLM) and Revenue Cloud, enterprise legal teams maintain a central Clause Library containing standard, fallback, and alternate contract clauses. The ClauseCatgConfiguration metadata type defines the structural Clause Categories (for example, Data Privacy & GDPR, Intellectual Property, Limitation of Liability, and Governing Law) used to classify those clauses.

Because ClauseCatgConfiguration is a first-class Metadata API type rather than volatile record data, architects can version-control the legal clause taxonomy in Git and promote it reliably alongside contract approval Flow definitions and document generation templates.

Directory Location and File Suffix#

In Salesforce DX projects, ClauseCatgConfiguration files are stored in the clauseCatgConfigurations folder.

Key Metadata Fields#

The following table lists the key XML elements of ClauseCatgConfiguration in API version 68.0 (Winter ’27):

Declarative Metadata Example#

The following ClauseCatgConfiguration metadata file defines a Limitation_of_Liability category for Contract Lifecycle Management:

<?xml version="1.0" encoding="UTF-8"?>
<ClauseCatgConfiguration xmlns="http://soap.sforce.com/2006/04/metadata">
    <description>Covers standard, mutual, and super-cap limitation of liability clauses requiring Legal Counsel review upon deviation.</description>
    <masterLabel>Limitation of Liability</masterLabel>
    <usageType>ContractLifecycleManagement</usageType>
</ClauseCatgConfiguration>

Package Manifest (package.xml)#

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>Limitation_of_Liability</members>
        <name>ClauseCatgConfiguration</name>
    </types>
    <version>68.0</version>
</Package>

SOQL Queries and SFDX CLI Commands#

You can query ClauseCatgConfiguration via SOQL or Tooling API to inspect configured legal clause categories in an org:

SELECT Id, DeveloperName, MasterLabel, UsageType, Description
FROM ClauseCatgConfiguration
ORDER BY MasterLabel ASC

Retrieve and deploy clause categories with the Salesforce CLI (sf):

# Retrieve all ClauseCatgConfiguration components
sf project retrieve start --metadata ClauseCatgConfiguration

# Deploy a specific ClauseCatgConfiguration component
sf project deploy start --metadata ClauseCatgConfiguration:Limitation_of_Liability

Architect Best Practices and Gotchas#

• Prerequisite Contract Settings: Ensure Salesforce Contracts (ContractSettings / CLM license) is enabled in the target org before deploying ClauseCatgConfiguration, or the deployment will fail with an invalid type error.
• Stable Developer Names: Avoid changing the filename (DeveloperName) of a deployed ClauseCatgConfiguration once DocumentClauseSet records in production reference it; update <masterLabel> instead if Legal renames a category.

Frequently asked questions

What is the purpose of ClauseCatgConfiguration in Salesforce Contracts?

It defines the taxonomy of legal clause categories (such as Indemnification, Limitation of Liability, or Confidentiality) used to organize Document Clause Sets in Salesforce Contracts Lifecycle Management.

Where are ClauseCatgConfiguration files located in SFDX source format?

They are stored in the force-app/main/default/clauseCatgConfigurations/ directory with the .clauseCatgConfiguration-meta.xml file extension.

Why should legal clause categories be managed as metadata rather than plain data records?

Managing ClauseCatgConfiguration as metadata ensures that contract generation templates, approval flows, and AI clause extraction rules reference identical category developer names across all sandboxes and production.

Which feature must be enabled in the target org to deploy ClauseCatgConfiguration?

Salesforce Contracts (Contract Lifecycle Management) must be enabled in the target org before deploying ClauseCatgConfiguration components.