---
title: "Clause Library Table"
canonical: "https://help.agiloft.com/space/SD/44434075/Clause+Library+Table"
format: markdown
---
The Clause Library table stores the standard clauses that are vetted and approved for use in contracts. Clauses from the Clause Library can be inserted into document templates and existing contracts using the [Agiloft Contract Assistant for Word](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43719560) app. Clause Library clauses are also used to review and edit third party paper.

Storing all of your clauses in a repository rather than in various documents on disk offers several benefits:

- Organization and searchability – Metadata on clauses allows you to control which clauses are available for which contract types, and users can filter clauses by type when building contracts and document templates.
- Easy reuse – By building document templates from library clauses, contracts are automatically generated with approved language.
- Single sourcing – If a clause needs to be updated, you only have to make the change in one place to ensure future contracts include the updated language.
- Clause prioritization – For clauses of the same type, you can rank clauses to prioritize their usage as well as define a list of alternate clauses to use as replacements.
- Multi-language support – Clauses that are translated to multiple languages are linked so you can manage them as a group. You can designate any language as the default language.
- Approval workflows – You can configure workflows to automate approvals for new or modified clauses. Note that the out-of-the-box Clause Library configuration doesn't include automated approval workflows.

# Record Creation

Users don't typically create Clause Library records directly in the table. Instead, clauses are added using the following methods:

- You add an approved or finalized [Contract Clause](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434124) to the library using the Add to Clause Library button.
- When [Managing a Clause Library](https://wiki.agiloft.com/display/HELP/Using+the+Word+app#UsingtheWordapp-anchor3ManagingaClauseLibrary) in the Word app, you click Generate Tags to use AI to extract clauses. Publishing the updates adds the extracted clauses to the Clause Library.
- When managing your Clause Library in the Word app, you manually tag clauses and publish the updates to add the tagged clauses to the library.
- You create an Excel workbook that includes the clause text and values for key columns and import it to the Clause Library table.

> ℹ️ For more information on adding clauses to your library, see [Configuring a Clause Library](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718534) in the Help Guide.

Clause Library records have several fields for managing the language in your contracts. The list below describes the key fields.

- **Clause Type**: The category the clause belongs in. Users can filter by clause type when searching for clauses.
- **Clause Title**: The unique name for the clause.
- **Default Risk Rating**: The level of risk for the clause on a scale of 0 (no risk) to 1 (highest risk).
- **Clause Priority**: Determines the order in which clauses of the same type are listed when presented to a user. The clause with the lowest value is first in the list. For example, if you have four variants for indemnification, set the highest priority clause to 1 so it's displayed first in the list, then number the remaining clauses 2 through 4, depending on the order they should appear. You can enter a decimal value to place a clause between two existing ordered clauses.
- **Clause Text**: Contains the text of the clause, using [document template syntax](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714847) for expressing content like field variables and conditions. For more information about this field, see [Storing Clause Text](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434075/Clause+Library+Table#clause_text) below.
- **Language**: Defines the language of the clause text.
- **Has Multiple Languages**: Indicates whether the clause is written in additional languages. When set to Yes, a related table displays the additional clauses.
- **Alternative Clauses Exist**: Indicates whether alternate clauses can be used in place of the clause. When set to Yes, a related table displays the list of fallback clauses.

## Cloning Clauses

If you want to make a copy of a clause for editing or translation, you can clone an existing record. To do so, select the clause record in the table view and select Clone Clause under More in the action bar.

![Clone Clause option under More in the action bar](media://785a3022-1c86-4580-a687-90e219f5e846)

The system makes a copy of the record, adds "Cloned on <date>" to the title, and maps most of the field values from the original record. You can edit the new record to adjust the title and modify fields as necessary.

> ℹ️ Note that Insert Clause Number is a legacy option that edits the Clause Text to add code for numbering the clause when it's added to a Word document. However, we don't recommend using this option. Instead, apply all styles and formatting to document templates, not individual clauses in the library.

## > Macro (anchor)

Storing Clause Text

Clause Text is a required field that stores the approved version of the clause text. This value is used for comparison when tracking changes made to contracts. When inserting Clause Library clauses into contracts and document templates in the Word app, this field is referenced by default. Clause Text is an HTML-based field that uses standard HTML formatting tags. To see formatting options, click the Edit button below the field to open the HTML editor. To make contracts consistent, however, style choices like font selection and formatting like numbering and indentation should be done in document templates, not in Clause Library clauses.

> ℹ️ Microsoft Word treats HTML text fields in a special way. Depending on HTML field characteristics, content may be translated in the Word document to either the Normal or Normal (Web) formatting style. Wrapping paragraphs in <p> elements results in Normal (Web) formatting. For consistency, it's important to configure document templates to set the same font, size, and spacing style for both Normal (Web) and Normal. For more information, see [Troubleshooting Document Templates](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718288).

You can include embedded images as encoded binary data. If you include hyperlinks, make sure to routinely check the links and make sure they're still functional. Pulling broken links into document templates can cause delays when using the Word app.

### Clause MS Word File

In addition to Clause Text, you can store a Microsoft Word version of the clause in the Clause MS Word File field. To use the contents of the file rather than the Clause Text in a document, reference the Clause MS Word File field: `$field_from_other_table(clause, <clause_ID>, clause_ms_word_file)`

For more information, see the Word File Examples in [Embedding Tables and Fields from Tables](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714372).

# Views

The out-of-the-box Clause Library table includes the [standard views](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718574). It also has a Detailed View that matches the Default View. The Default View shows the Edit icon, ID, Clause Title, Clause Type, Default Risk Rating, and Clause Text fields.

![Default View for the Clause Library table](media://52da89cf-9285-4cd3-9707-3cc678c85f1f)

# Related Tables

The diagram below shows the default incoming table relationships and linked fields in the Clause Library table.

![Default table relationships for the Clause Library table](media://bf1db580-1a83-45e9-a6b6-baef2910e57c)

# 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 Clause Library 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. |
| AI Clause Type  
AI Clause Type Description  
Clause Type  
Default Risk Rating  
Clause Type ID  
Clause Type Risk Multiplier | Link to selected fields from other table: Clause Types | Identifies the clause type for the clause. This Word app requires this field. |
| Alternative Clauses Exist | Choice: Yes, No | Indicates whether there are alternate clauses that can be used in place of this clause. |
| Approval Team  
Approval Team ID | Link to selected fields from other table: Teams | The team assigned to approve the clause. |
| Approved By  
Approved By ID | Link to selected fields from other table: People | The person who approved the clause. |
| Available for Contract Types | Link to single field from other table: Contract Types | Contract Types that can use this clause. Controls visibility in the Word app. |
| Boilerplate? | Choice: Yes, No | Indicates whether this is a boilerplate clause. |
| Button: Add Clause Number | Action button | If you want to control clause numbering in library clauses rather than document templates, this button to adds Microsoft Word code that results in auto-numbering in front of the clause when it's used a document template. |
| Button: Clone Clause | Action button | Creates a copy of the current clause. |
| Button: Remove Clause Number | Action button | Removes the Microsoft Word code that results in auto-numbering in front of the clause when it's used a document template. |
| Clause MS Word File | File with Versioning | Stores the Microsoft Word version of the clause if the clause is maintained in a separate file. |
| Clause Owner  
Clause Owner ID | Link to selected fields from other table: People | Lists the person who owns the clause. |
| Clause Priority | Floating Point | Indicates the priority of this clause compared to other clauses of the same type. Determines the order in which clauses are listed when users view clauses by type. The default clause or clause with highest priority should be number 1. |
| Clause Text | Text | The text of the clause in HTML format. |
| Clause Title | Short Text | The unique name of the clause. |
| Clause Usage | Choice: Default, Optional, Conditional, Fallback | Defines the circumstances under which the clause is used. |
| Condition | Variable Formula | If Clause Usage is Conditional, this field specifies the condition to evaluate. |
| Contract Clause Source Clause ID  
Source Contract Clause ID  
Contract Clause Most Similar Clause ID  
Contract Clause Source | Link to selected fields from other table: Contract Clauses | These fields identify the source of the Contract Clause if this clause was added to the library from the Contract Clauses table. |
| Date Approved | Date | The date the Status was set to Active. |
| Date Replaced | Date | If the clause was replaced, this is the date it was replaced. |
| Language  
Default Language  
Language ID | Link to selected fields from other table: Languages | The language the clause is written in. Defaults to English. |
| Fallback Clauses | Related Table: Clause Library | If Alternative Clauses Exist is Yes, this field lists the alternate clauses. |
| Fallback for Clause Text  
Fallback for Clause Title  
Fallback for Clause ID | Link to selected fields from other table: Clause Library | If Playbook is Fallback, this field links to the clause for which this clause is a fallback. |
| Fingerprint | Long integer field | A hash value that represents the fingerprint for the clause. Used in evaluations for similarity. |
| Guidance | Text | Lists the guidance to provide to a user when deciding whether or when to use the clause. |
| Has Multiple Languages | Choice: Yes, No | Indicates whether the clause is translated to languages other than English. |
| Linked Default Clause ID | Link to selected fields from other table: Clause Library | For fallback clauses, this field specifies the default clause for which this is a fallback. |
| Maximum Contract Amount | Currency | When Clause Usage is Conditional, this field defines the maximum contract amount. It's used to set insurance clauses. |
| Minimum Contract Amount | Currency | When Clause Usage is Conditional, this field defines the minimum contract amount. It's used to set insurance clauses. |
| OOXML Clause Text | Text | The Office Open XML version of the clause from the .docx file. |
| Other Language Clauses | Related Table: Clause Library | If the clause is translated to additional languages, this field lists the other clauses. |
| Owned by Team  
Owned by Team ID | Link to selected fields from other table: Teams | Identifies the team that owns the clause. |
| Parent English Language Clause Title  
Parent English Language Clause ID | Link to selected fields from other table: Clause Library | For clauses in languages other than English, these fields identify the English version of the clause. |
| Playbook | Choice: Standard, Fallback | The playbook that includes the clause. |
| Replaced by Clause Title  
Replaced by Clause ID | Link to selected fields from other table: Clause Library | If a clause is replaced, these fields identify the clause that replaced it. |
| Risk Relevance Rating | Integer | A value from 1 to 5 that defines the risk relevance. This field is not currently used. |
| Source | Choice: Standard, From Negotiated Agreement, Revision | The source of the clause. |
| Source Clause Title  
Source Clause ID | Link to selected fields from other table: Clause Library | For cloned clauses, these fields identify the original source clause. |
| Source Contract Title  
Source Contract Type  
Source Contract Type ID  
Source Contract ID  
Source Contract Template ID | Link to selected fields from other table: Contracts | Source of this clause if it was created from a contract. |
| Status | Choice: The states defined in the [workflow](#) | The status of the clause. The default value is Active. |
| Used by Document Templates | Link to single field from other table: Document Templates | Lists any document templates that use this clause. |
| Used in Document Templates | Related Table: Document Template Clauses | Lists the document template clauses that are linked to this clause. |

# Automation

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

- **Create: Clause Creation actions (web)**: This rule runs when a clause is cloned via the Clone Clause action under More in the table view. The rule performs the following actions on the new record:
  - Appends "- Cloned On <date>" to the title.
  - If Source Contract Clause ID is populated, it sets the Source value to From Negotiated Agreement.
  - If Contract Clause Source Clause ID is populated, indicating the source clause was created from contract negotiation, it sets Linked Default Clause ID to the Contract Clause Source Clause ID.
  - If Contract Clause Most Similar Clause ID is populated, indicating the source clause was created from an extraction, it sets Linked Default Clause ID to the Contract Clause Most Similar Clause ID.
  - Sets the Fingerprint value.
- **Edit: Set Fingerprint on Edit (web, API)**: This rule runs when a record is edited and calculates the Fingerprint value.

# > Macro (anchor)

Workflow

This section describes the out-of-the-box workflow for the Clause Library 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 an Active state. The Status field is set to Active, making the clause available for use in contracts and document templates.

![image](media://ef51212c-1347-416f-bc79-74d123e799c1)

Active records can transition to Pending Approval, Retired, or Replaced. There aren't any actions or guards in the workflow or automation rules on the table that control status updates.