---
title: "Contract Clauses Table"
canonical: "https://help.agiloft.com/space/SD/44434124/Contract+Clauses+Table"
format: markdown
---
The Contract Clauses table stores all of the clauses that are included in contracts. The source of the clause can be internal, such as from the [Clause Library](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434075), or from a third-party document. Contract Clauses are created from documents when you extract or tag clauses with AI, when users manually tag clauses, and when a Clause Library clause is added to a contract, such as when a contract is generated from a document template.

The Contract Clauses table is similar to the Clause Library, but there are key differences in their purpose:

- The Clause Library stores the standard clauses your legal organization has approved for use.
  - When you add clauses to contracts and document templates in the Agiloft Contract Assistant for Word app, those clauses usually come from the Clause Library.
- The Contract Clauses table stores the "live" versions of clauses that exist in contract documents.
  - When a clause from the Clause Library is added to a contract, a version of the clause is added to Contract Clauses and linked to the contract. Library clauses are not linked to specific contracts.
  - Contract Clause language may evolve with review and negotiation. Contract Clause records track all of the redlines or changes made to clauses over time.

The diagram below illustrates clause usage from Contract Clauses versus the Clause Library. While a Clause Library clause might be the original source of a Contract Clause, Clause Library clauses aren't linked directly to specific contracts.

![Diagram of Contract Clause and Clause Library usage](media://9f7d741c-d802-4b2c-9cef-d9ce23f53ba8)

# Record Creation

Users don't typically create Contract Clauses directly in the table. Instead, records are automatically generated in the following scenarios:

- When a contract is generated from a document template. A Contract Clause record is created for each clause in the generated document.
- When a clause is manually tagged in the Agiloft Contract Assistant for Word app and then and published to Agiloft.
- When a clause from the Clause Library is inserted into a document in the Word app and the changes are published.
- When clauses are extracted by AI using the Generate Tags feature in the Word app.
- When clauses are extracted by AI using the Analyze Contract feature in the Document Viewer or an Attachment record.

> ℹ️ For information on using the Word app, see [Agiloft Contract Assistant for Word](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43719560) in the Help Guide.

The sections below give a high-level overview of the out-of-the-box record layout. Each tab is listed below, with descriptions of the main features, action buttons, and fields included in the layout by default.

## Common Area

When a Contract Clause record is generated, the Status is set to Created, and the system populates the clause Source and Contract Clause Type. Source is one of the following values:

- **Added from Library**: The source of the clause is the Clause Library. This value indicates a user edited the contract and inserted a clause from the library.
- **Document Template**: The source of the clause is a document template. This value indicates a user generated a contract from a document template.
- **Extracted/Tagged Clause**: The source of the clause is extraction or tagging by AI or manual tagging by a user.
- **New**: This value is not set by the system but can be chosen manually.

## Contract Clause

On the Contract Clause tab, the system populates the Current Clause Text and Source Text. The Source Text field contains the original, baseline version of the clause text. If the clause is from the Clause Library, Source Text matches the library clause. The Current Clause Text always contains the most recent version of the clause. The content matches the Source Text until the clause is edited.

When a contract clause is edited, the Current Clause Text is updated to the latest version of the text, and the Current Markup field shows the differences between the Source Text and Current Text. 

![ Contract Clause record that shows text modifications](media://c6532f76-a778-4bfe-ad91-9c24d0c45447)

The record also lists any fallback clauses and obligations associated with the clause and gives you the option to create an obligation for the parent contract.

## Contract Details

The Contract Details tab provides details about the contract the clause is used in as well as the source document template if the contract originated from a template. 

![Contract Details tab](media://c8866d01-e6a3-4b42-bc90-7f3a48cb5dc7)

# Views

The Default View for the out-of-the-box Contract Clauses table shows the Edit icon, ID, Contract Clause Type, Contract ID, Contract Title, Library Clause Title, Current Markup, Current Clause Text, and Source fields.

![Default View for the Contract Clauses table](media://0ba1c5ad-4cdb-45cd-b031-e4ae955b8d8e)

In addition to Default View and other [standard views](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718574), the table includes the following views:

- **Extracted Clauses View**: Includes the Source and Extracted Confidence Score columns as well as a View Popover icon. Clicking the icon displays the Current Clause Text and Current Markup for comparison.
- **View in Contract**: Default view for displaying the Contract Clauses related table on the Attachments tab in Contract records.

# Saved Searches

The out-of-the-box Contract Clauses table includes several saved searches that are used by rules. The following saved search is available in the navigation menu by default:

- **Source Added from Library**: Finds all records where the Source is Added from Library.

# Charts/Reports

In the out-of-the-box system, the Contract Clauses table includes the following charts and reports.

- **Clause Types used, segmented by whether modified**: Reports on how many Finalized and Approved clauses of each Clause Type are used and whether they're modified from the original text.
  - The bar chart shows the number of clauses used for each Clause Type, segmented by whether they're modified from the original version.
  - The report lists each of the clauses that are used, grouped by Clause Type.
- **Clauses modified in unsigned contracts**: Report that lists all clauses that were modified from the default in contracts that are not yet signed.
- **Force Majeure clauses modified in the past 12 months**: Report that lists all Force Majeure clauses that were modified in the last year.
- **Modified Clauses by Clause Type**: Reports on the number of clauses that are modified.
  - The bar chart shows the number of clauses by Clause Type that were changed at any time.
  - The report lists each of the modified clauses grouped by Clause Type.
- **Modified Clauses by Contract Type**: Reports on the clauses in post-Approved contracts that were modified, grouped by Contract Type.
  - The pie chart counts the number of clauses that were modified, segmented by Contract Type.
  - The report lists each of the modified clauses, grouped by Contract Type.
- **Modified Limitation of Liability Clauses in Active Contracts**: Report that lists all Limitation of Liability clauses that were modified in Active contracts.

For information on working with charts and reports, see [Create and Edit Charts and Reports](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714395) in the Help Guide.

# Related Tables

The diagram below shows the default table relationships and linked fields in the Contract Clauses table.

![Diagram of the default table relationships for the Contract Clauses table](media://23c9db1b-42e4-424b-9f01-16e056c7265b)

# Fields

In addition to the [standard fields](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434023/Table+Concepts#standard_fields), the out-of-the-box Contract Clauses table includes the following fields.

| **Field Label** | **Data Type** | **Description** |
| --- | --- | --- |
| ACA Update | Choice: Yes, No | System-managed field that indicates whether the clause was created or updated via the Agiloft Contract Assistant for Word app. |
| Approval Team  
Source Library Clause Text  
Library Clause Title  
Library Clause Type  
Library Clause Type ID  
Clause Type Default Risk Rating  
Library Clause Fingerprint  
Library Clause ID | Link to selected fields from other table: Clause Library | If the Source of the clause is Document Template or Added from Library, these fields identify the linked clause from the Clause Library. |
| Button: Add to Clause Library | Action button | Creates a copy of the clause and adds it to the Clause Library. The button is visible when Status is Finalized or Approved. |
| Button: Create Contract Obligation | Action button | Creates a Task record where you enter details about the obligation. |
| Calculated Similarity Risk | Calculated Result |  |
| Clause Tag Tracker For System Use (Do not modify) | Text | System-managed field for tracking tags. Do not modify or remove this field. |
| Clause Type Has Obligation  
Contract Clause Type  
Obligation Task Type ID  
Clause Type Risk Rating  
Contract Clause Type ID  
Show Clause Type in Contract  
Clause Type Risk Multiplier | Link to selected fields from other table: Clause Types | This is the direct link to the clause type.  Set by default for Extracted clauses to the one that contains the extracted AI clause type with the highest risk rating.  It will be set by a rule for those that are from the clause library. |
| Company Name  
Contract Start Date  
Contract Title  
Contract Type  
Contract Document Source  
Contract ID  
Document Template File  
Document Template ID  
Document Template  
Contract Status | Link to selected fields from other table: Contracts | These fields identify the contract and document template the clause is used in. |
| Current Clause Text | Text | This field contains the latest clause text with all redlines accepted. |
| Current Markup | Text | This field contains the current clause text with markup showing the changes from the baseline version of the clause from the Clause Library. |
| Extract Clauses button Clicked? | Choice: Yes, No | This flag is set automatically when clauses are extracted with AI. |
| Extracted AI Clause Type  
Extracted AI Clause Type ID | Link to selected fields from other table: AI Clause Types | If the clause was extracted by AI, these field identify the clause type. |
| Extracted Clause Text | Text | Contains the clause text that was extracted by AI. |
| Extracted Clause Type | Short Text | The clause type extracted by AI. |
| Extracted Confidence Score | Percentage | The confidence score set by AI. |
| Fallback Clauses | Embedded Search Result | For clauses from document templates or the Clause Library, this field lists any fallback clauses for the current clause. |
| Fingerprint | Long integer | A hash value that represents the fingerprint for the clause. Used in evaluations for similarity. |
| Flag to Trigger Clause Type Obligation | Choice: Yes, No | System-managed flag used to trigger automation. |
| Include Obligation Management  
Obligation Function ID | Link to selected fields from other table: Functions | Set default value of the record for Obligation Management, with its yes/no field here pulled into all contract clauses, to use for visibility dependency of the obligation functionality. |
| Latest Contract ID | Link to selected fields from other table: Contracts | Used by the system to link to the Contract when creating obligations from task templates. |
| Matching Library Clauses | Link to selected fields from other table: Clause Library | This field is used to match extracted Clauses type with the standard clause type in the clauses library table based on the contract type.   
This field is used to as corpus by the Similarity model to find the most similar clause library ID. |
| Modified From Default | Choice: Yes, No | Indicates whether the clause was changed from the baseline text. Used to report on clauses that have been modified from their original text. |
| Most Similar Clause Text  
Most Similar Clause Title  
Most Similar Clause Default Risk Rating  
Most Similar Clause ID | Link to selected fields from other table: Clause Library | This would be set by AI if AI is deployed.  Otherwise it can be used to manually select a similar clause for purposes of rating risk or using text from that clause. |
| Obligation Task Type for Conversion | Choice: Task, Approval, Milestone, Obligation, Notification | Indicates the type of Task record to create when adding obligations. Defaults to Obligation. |
| Obligations | Related Table: Tasks | Lists any obligations associated with the clause. |
| OOXML Clause Text | Text | The Office Open XML version of the clause from the .docx file. |
| Risk Category | Choice: Low, Medium, High | Categorizes the clause’s level of risk. |
| Similarity Metric | Choice: cosine, Chebyshev | For clauses extracted by AI, this field indicates which metric is used to measure the similarity between clauses. |
| Similarity Model JSON output | Text | Stores the output from the similarity model for clauses extracted by AI. |
| Similarity Risk Rating | Floating Point |  |
| Similarity Risk Rating for Library Clause | Floating Point | For clauses where the Source is Document Template or Added from Library, this field calculates the similarity risk rating. |
| Similarity to Source Clause | Floating Point | For clauses extracted by AI, the similarity model sets this value according to how similar the extracted clause is to the Clause Library clause. |
| Source | Choice: Document Template, Added from Library, Extracted/Tagged Clause, New | Indicates the source of the clause. |
| Source Attached File  
Source Attachment ID  
Source Attachment Status | Link to selected fields from other table: Attachments | Links to the attachment that contains the clause. |
| Source Text | Text | Stores the original clause text from when the Contract Clause was created. This field is used to compare updated text against the original source. |
| Status | Choice: The states defined in the [workflow](#) | The state of the clause. |
| Task Related to for Conversion | Choice: Standalone, Contracts, Contract Requests, Obligations, People, Sourcing Events, Supplier Profile | For clauses that include obligations, this field identifies the type of parent record for the obligation. Defaults to Contracts. |
| Template Clause Usage  
Document Template Clause ID  
Document Template Clause Sort Order | Link to selected fields from other table: Document Template Clauses | Identifies the document template the clause was generated from. |

# Automation

This section describes the active rules that are implemented for the out-of-the-box Contract Clauses table. For details about rule configuration options, see [Rules](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714473) in the Help Guide.

- **Edit: Handle status changes and updates (do not run on creation after other rules) (web, API)**: This rule runs when a Contract Clause record is edited. It performs the following actions:
  - If the Clause Text was changed, it sets the Modified From Default flag to Yes, sets the Status to Modified, and calculates the Fingerprint value.
  - If the Clause Text was removed, it sets the Modified From Default flag to Yes and sets the Status to Deleted.
  - If the Contract Status is Signed or Active and the Clause Status is Approved, Modified, or Created, it sets the Clause Status to Finalized.
- **Create: all create rules for contract clauses (web, API)**: This rule runs when a Contract Clause is created. It updates the attachment and contract links and performs the following actions:
  - If the clause didn't originate from the Clause Library, it sets the Source to Extracted/Tagged Clause.
  - If the clause was extracted with AI, it sets the Source to Extracted/Tagged Clause and sets the Extracted Confidence Score.
  - If the clause originated in the Clause Library, it copies the Clause Text to the Source Text field. If Similarity to Source Clause is empty, it sets the value to 0 and calculates the Similarity Risk Rating.
- **Flag to Trigger Clause Type Obligation is Yes (web, API)**: This rule runs when a record is edited. If Flag to Trigger Clause Type Obligation is Yes, the rule finds the Task Template record for the obligation and generates a Task for the contract.

# > Macro (anchor)

Workflow

This section describes the out-of-the-box workflow that is configured for the Contract Clauses table. For information on configuring workflows, see [Workflows](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718058) in the Help Guide.

By default, new records are in a Created state. The Status field is set to Created. Created records can transition to Modified, Deleted, Approved, and Finalized.

![Out-of-the-box Workflow for the Contract Clauses table](media://51bf5bca-14cf-457a-bab3-00072aff4c36)

There aren't any guards or actions that prevent Created records from transitioning to any other state. When Contract Clauses are edited, an automation rule handles status changes:

- When clause text is changed, the state is changed to Modified.
- When the clause text is deleted, the state is changed to Deleted.
- When the Contract Status is Signed or Active, the state is changed to Finalized.
- Changing the Status to Approved is a manual process. The out-of-the box table doesn't include automation for approvals.

The Status field can also be changed manually by the admin, Admin Import, Business Admin, Contract Admin, Contract Manager, and Contract Requester groups. In addition, Contract Creators can edit the Status of their own records.