Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Recognizes text.

Component Version macOS Windows Linux Server iOS SDK
Vision 9.4 ✅ Yes ✅ Yes ❌ No ✅ Yes, on macOS and Windows ✅ Yes
MBS( "Vision.RecognizeText"; Image { ; Recognition Levels; Languages; CustomWords; PageLimit } )   More


Parameter Description Example Flags
Image The image to analyze.
Can be container value with JPEG, PNG or other image formats supported by Vision framework.
Recognition Levels Can be "Fast" or "Accurate".
macOS and iOS only. Ignored on Windows.
"Accurate" Optional
Languages Specify the languages used for the detection.
The order of the languages in the array defines the order in which languages will be used during the language processing.
The languages are specified as ISO language codes.
"en_US" Optional
CustomWords An array of strings that will be used at the word recognition stage in addition to the recognition languages. The customWords list takes precedence over the standard lexicon.
macOS and iOS only. Ignored on Windows.
"FileMaker¶Claris" Optional
PageLimit Available in MBS FileMaker Plugin 12.3 or newer.
The maximum page count allowed for PDF pages.
Default is 1 to only look on first page.
It is highly recommended to use a limit to only get text from first n pages due to the time it takes to render pages and recognize text.
Pass 0 for no limit.
1 Optional


Returns list or error.


Recognizes text.
Requires MacOS 10.15 or iOS 13.0 or newer. This similar to the GetLiveText function in FileMaker 19.5 and later.

If you need cross platform text recognition, please check our OCR functions.

Added PDF support for plugin version 12.3. PDF pages can now be rendered and run through recognition.
For PDF files, you may also check PDFKit.GetPDFPageText and PDFKit.GetPDFText to extract text directly.

Implemented Windows version for images via WindowsOCR functions in v13.1. If languages is empty, uses current language of user. Recognition levels and custom words are not supported for Windows. See also WindowsOCR.Recognize function.


Recognize text:

Set Field [ Vision::Result ; MBS( "Vision.RecognizeText"; Vision::Image; "Accurate") ]

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2019, last changed 5th February 2023

Vision.KnownClassifications - Vision.RecognizeTextJSON