<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Vision",
  "identifier" : "/documentation/Vision/VNRecognizeTextRequest",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Vision"
    ],
    "preciseIdentifier" : "c:objc(cs)VNRecognizeTextRequest"
  },
  "title" : "VNRecognizeTextRequest"
}
-->

# VNRecognizeTextRequest

An image-analysis request that finds and recognizes text in an image.

```
class VNRecognizeTextRequest
```

## Overview

By default, a text recognition request first locates all possible glyphs or characters in the input image, and then analyzes each string. To specify or limit the languages to find in the request, set the [`recognitionLanguages`](/documentation/Vision/VNRecognizeTextRequest/recognitionLanguages) property to an array that contains the names of the languages of text you want to recognize. Vision returns the result of this request in a [`VNRecognizedTextObservation`](/documentation/Vision/VNRecognizedTextObservation) object.

## Topics

### Customizing Recognition Constraints

[`minimumTextHeight`](/documentation/Vision/VNRecognizeTextRequest/minimumTextHeight)

The minimum height, relative to the image height, of the text to recognize.

[`recognitionLevel`](/documentation/Vision/VNRecognizeTextRequest/recognitionLevel)

A value that determines whether the request prioritizes accuracy or speed in text recognition.

[`VNRequestTextRecognitionLevel`](/documentation/Vision/VNRequestTextRecognitionLevel)

Constants that identify the performance and accuracy of the text recognition.

### Accessing the Results

[`results`](/documentation/Vision/VNRecognizeTextRequest/results)

The results of the text recognition request.

### Specifying the Language

[`automaticallyDetectsLanguage`](/documentation/Vision/VNRecognizeTextRequest/automaticallyDetectsLanguage)

A Boolean value that indicates whether to attempt detecting the language to use the appropriate model for recognition and language correction.

[`recognitionLanguages`](/documentation/Vision/VNRecognizeTextRequest/recognitionLanguages)

An array of languages to detect, in priority order.

[`usesLanguageCorrection`](/documentation/Vision/VNRecognizeTextRequest/usesLanguageCorrection)

A Boolean value that indicates whether the request applies language correction during the recognition process.

[`customWords`](/documentation/Vision/VNRecognizeTextRequest/customWords)

An array of strings to supplement the recognized languages at the word-recognition stage.

[`supportedRecognitionLanguages()`](/documentation/Vision/VNRecognizeTextRequest/supportedRecognitionLanguages())

Returns the identifiers of the languages that the request supports.

[`supportedRecognitionLanguages(for:revision:)`](/documentation/Vision/VNRecognizeTextRequest/supportedRecognitionLanguages(for:revision:))

Requests a list of languages that the specified revision recognizes.

### Identifying Request Revisions

[`VNRecognizeTextRequestRevision3`](/documentation/Vision/VNRecognizeTextRequestRevision3)

A constant for specifying revision 3 of the text recognition request.

[`VNRecognizeTextRequestRevision2`](/documentation/Vision/VNRecognizeTextRequestRevision2)

A constant for specifying revision 2 of the text recognition request.

[`VNRecognizeTextRequestRevision1`](/documentation/Vision/VNRecognizeTextRequestRevision1)

A constant for specifying revision 1 of the text recognition request.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)