# OCROptions

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.OCROptions/

Struct for OCR options.

- **Full name:** `MFiles.OCROptions`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-languages"></a>`languages` | repeated [`OCRLanguageType`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.OCRLanguageType/index.md) | 1 | Languages/character sets/dictionaries to be used as recognition hints. Can be unset. |
| <a id="f-ocr_automatic_language_detection"></a>`ocr_automatic_language_detection` | `bool` | 2 | True if the OCR automatic language detection is to be used. |

<a id="used-by-methods"></a>

## Used by methods

- [IRPCScanningAndOCR.OCROperation_Begin](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCScanningAndOCR/OCROperation_Begin/index.md): Starts an OCR job on a file of a document that the caller has checked out.
- [IRPCScanningAndOCR.OCROperation_BeginAfterUpload](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCScanningAndOCR/OCROperation_BeginAfterUpload/index.md): Starts an OCR job on a file that the caller uploaded with UploadTempFile.
- [IRPCScanningAndOCR.OCRUploadedFile](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCScanningAndOCR/OCRUploadedFile/index.md): Starts an OCR job that converts the file of a stateless upload to a searchable PDF.

<a id="used-in-fields"></a>

## Used in fields

- [`OCRBlock.options`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.OCRBlock/index.md#f-options): OCR options used for this block. If unset, default settings are used.
- [`ScanningAndOCROptions.ocr_options`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ScanningAndOCROptions/index.md#f-ocr_options): Default options for OCR.
- [`OCROperation_BeginAfterUploadRequest.options`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCScanningAndOCR/OCROperation_BeginAfterUpload/index.md#request): Recognition languages and automatic language detection. Unset uses the defaults.
- [`OCROperation_BeginRequest.options`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCScanningAndOCR/OCROperation_Begin/index.md#request): Recognition languages and automatic language detection. Unset uses the defaults.
- [`OCRUploadedFileRequest.options`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCScanningAndOCR/OCRUploadedFile/index.md#request): OCR options to be used for this job. If unset, default settings are used.