---
title: "Contracts OCR"
description: "To access the Contracts Image Viewer and functions such as search and navigation, you must run Contracts OCR. Contracts OCR (Optical Character Recognition) converts images of text, such as scanned and redacted documents, into machine-readable text characters."
feature: "Contracts"
audience: ["end user", "developer", "system analyst", "system administrator", "system engineer"]
version: "Relativity aiR"
type: ["User Guide", "Tutorial"]
url: "https://help.relativity.com/RelativityaiR/Content/Contracts/Contracts_OCR.htm"
lastModified: "2026-10-29"
---

# Contracts OCR

Contracts OCR (Optical Character Recognition) converts images of text—such as scanned and redacted documents—into machine-readable text characters. When you run Contracts OCR, it also captures word-level location data, which maps extracted text to the document image so that terms are highlighted accurately in the Contracts Image Viewer.

You must run Contracts OCR before you can use the Contracts Image Viewer and its search and navigation features.

## Prerequisites

Before you run Contracts OCR, verify the following:

- Run Imaging first—You must run Imaging and successfully generate images for each document. If no images exist, there is nothing for Contracts OCR to process. For more information, see [Imaging](https://help.relativity.com/RelativityaiR/Content/Relativity/Imaging/Imaging.md).
- Verify the Contracts Extracted Text field is empty—Contracts OCR skips documents that already have a value in the Contracts Extracted Text field. To overwrite existing values, see [Rerun Contracts OCR](#Rerunnin).
- Check image dimensions—Images must not exceed 32,000 pixels in either dimension. The Contracts OCR engine does not support larger images.
- Exclude Section documents—Contracts OCR and Analysis do not process Section documents. These documents, created by Contracts Segmentation, are automatically excluded. You can identify them by Document Identifiers ending in .htk.

## Run Contracts OCR

To run Contracts OCR:

1. Go to the **Contracts OCR Sets** tab.
2. Click **New Contracts OCR Set**.
3. Enter a **Name** for the Contracts OCR Set.
4. For **Data Source**, select a saved search that contains the documents you want to OCR.
5. For **Language**, select the language or languages you want the OCR engine to recognize.  
   For a list of languages supported by Contracts OCR see [Supported languages matrix](https://help.relativity.com/RelativityaiR/Content/Solutions/Supported_languages_matrix.md).
6. Optional) Under **OCR Set Notification**, enter the email addresses of users you want to notify when the OCR job completes.
7. Click **Save**.  
   ![An image of the Contracts OCR Sets page](https://help.relativity.com/RelativityaiR/Content/Resources/Images/Contracts/SCR_contracts-ocrset.png)
8. Click **Run OCR** in the right console.

If errors occur, click **Download Errors** in the console to download and review the error report.  
![An image of the Management Console with the Download errors button selected.](https://help.relativity.com/RelativityaiR/Content/Resources/Images/Contracts/SCR_contracts-ocr2.png)

### Fields auto-populated by Contracts

Below is a list of all fields that Contracts will auto-populate when you run imaging and OCR.

| Field name | Field type | Field auto population |
| --- | --- | --- |
| Contracts Extracted Text | Long-text | Contains the OCR-extracted text of the document. |

> **Note:** If you manually edit the Contracts Extracted Text field and then rerun Imaging and OCR, the new OCR results replace your manual edits.

## Rerun Contracts OCR

By default, Contracts OCR skips documents that already have a value in the Contracts Extracted Text field. To overwrite existing extracted text, you must enable the overwrite setting.

To rerun Contracts OCR:

1. Navigate to your Contracts OCR set and select **Edit**.
2. Set **Overwrite Contracts Extracted Text** to **Yes**.  
   ![The overwrite contracts extracted control showing yes and no options.](https://help.relativity.com/RelativityaiR/Content/Resources/Images/Contracts/SCR_Overwrite-text.png)
3. Click **Save**.
4. Click **Run OCR** in the right console.

> **Note:** If the documents in your saved search do not have values in the Contracts Extracted Text field, the overwrite setting has no effect, because there is nothing to overwrite.
