Skip to main content

Settings

Explore the extensive set of customization options offered by Veryfi Lens.

Download on theApp StoreDownload on theGoogle Play

SETTINGDESCRIPTION
accentColorAccent color used by material design
accentDarkColorAccent dark color used by material design
afterScanCloseCameraIsOnEnables a menu option in camera settings that allows users to close the camera after scanning a document
alertBackgroundColorDefines background color of custom alerts
alertBackgroundDarkColorDefines background color of custom alerts for dark mode
alertFontColorDefines font color of custom alerts
alertFontDarkColorDefines font color of custom alerts for dark mode
alertButtonHeightHeight value for custom alert CTA button
alertButtonCornerRadiusCorner radius value for custom alert CTA button
alertContentMarginsControls the content margins of custom alerts
alertContentSpacingControls the content spacing of custom alerts
alertSheetStyleIsOnIf disabled makes default sheet alerts display as regular alerts
allowSubmitLowQualityDocsIsOnAllows low quality images to be uploaded
allowSubmitUndetectedDocsIsOnActivate this setting to require users to capture only valid receipts
anyDocumentTemplatePicks which document template will be used for any_document data extraction
anyDocumentTypeTakes a string that extracts data on any of the supported documents
appVersionSpecifies the version string of the Lens SDK client app
autoCaptureFrameConfidenceModify it to increase/shorten auto capture speed
autoCaptureMarginRatioForce a the document to be at a certain distance from the edges
autoCaptureIsOnAllow the app to automatically capture the document, selecting the best frame
autoCaptureOtherIsOnAllow the app to automatically capture the document, selecting the best frame for Other document type
autoCropBrowserIsOnApplies document detection and auto-cropping on documents imported from the file browser
autoCropGalleryIsOnApplies document detection and auto-cropping on documents imported from the image gallery
autoDeleteAfterProcessingAutomatically deletes documents from the server once they have been processed
autoDeleteLocalResourcesAfterProcessingAutomatically delete the documents saved locally
autoDocDetectionAndCropIsOnAutomatically detect, highlight, and crop documents during camera image capture
autoLightDetectionIsOnControl the automatic illumination of documents by enabling or disabling the Auto Light Detection
autoRotateIsOnAutomatically rotate captured images, ensuring the contained document is correctly oriented
autoSkewCorrectionIsOnAutomatically correct image skewing during the capture process
autoSubmitDocumentOnCaptureSkip Document Preview screen and send the scanned document just right after capture
autoTagDeviceIdToggle the Auto Tag Device Id setting
autoTagLensVersionToggle the Auto Tag Lens Version setting
autoTagPlatformToggle the Auto Tag Platform setting
autoTagSourceTag automatically document sources
backgroundColorConfirmationScreenBackground color displayed on the Confirmation Screen
backgroundDarkColorConfirmationScreenBackground color displayed on the Confirmation Screen for dark mode
backupDocsToGalleryUses photo gallery to back up each scan
backupDocsToiCloudAllows backing up scanned images in iCloud Documents folder
barcodeExtractionIsOnAllows your app to extract information from barcodes found on documents
blurDetectionInAutoCaptureIsOnIf enabled it will process the image for blur after auto capture
blurDetectionIsOnChecks if a captured picture has 20% or more blur
boostModeIsOnToggle the Boost Mode setting to increase the processing speed of documents within the app
boundingBoxesIsOnEnable to return the coordinates for the location of fields on the document
browseDocumentDetectorIsOnEnables the document detector option for the file browser
browseIsOnEnable or disable the ability for users to browse documents using the phone's file explorer app
browseOtherIsOnEnable or disable the Browse option for the other document type
buttonFontFont for buttons in Lens UI
buttonFontSizeFont size for buttons in preview and similar screens
buttonFullWidthMake scan preview button to fill the whole available horizontal space
buttonHeightControls the height of scan preview button
buttonHorizontalPaddingAdds horizontal spacing of scan preview button when in full width
buttonTopPaddingAdds top spacing to scan preview button
cameraProcessingModeSpecifies the scanning mode in camera between document and card modes. This setting is only valid when using any_document type in documentTypes
categoriesOptional list of custom categories for Veryfi to use in categorizing submitted documents
checkSequenceModeAlternative experience of scanning checks both front and back sides
checksBackIsOnEnable or disable the capture of the back side of checks after the front side has been taken
checksBackIsRequiredEnable this setting to require users to capture the back side of checks after the front side has been taken
cleanBorderIsOnEnable or disable the clean-borders post-processing feature
closeCameraOnSubmitLens camera view will automatically close after a user submits an image, returning them to the host application
computeIsOnToggle the Compute flag to enrich document extraction on certain fields
confidenceDetailsIsOnEnable to receive additional information about the confidence level of the inference
creditCardAutoCaptureModeConfigures the credit card capture mode, allowing to prioritize speed, accuracy or normal
creditCardDetectCardCVCConfigure if the scanner should detect the credit card CVC
creditCardDetectCardDateConfigure if the scanner should detect the credit card date
creditCardDetectCardHolderNameConfigure if the scanner should detect the credit card holder's name
creditCardDetectCardNumberConfigure if the scanner should detect the credit card number
creditCardMarginBottomCredit card's bottom margin
creditCardMarginTopCredit card's top margin
customLensStringsCustomize localizable strings in lens UI by setting a key:value object
dataExtractionEngineConfigure whether a document should be sent to the server or if the whole processing should be done locally
defaultSelectedDocumentTypeAllows selection of the default document type
detectBlurResponseIsOnEnable or disable the is_blurry response
deviceUserUuidAllow passing the UUID4 of our customer's unique user login
dewarpingIsOnActivate or deactivate the dewarping algorithm, which corrects image distortion
dialogLeftButtonTextColorColor used for the text in the left button in the dialogs
dialogLeftButtonTextColorDarkColor used for the text in the left button in the dialogs for dark mode
dialogMessageColorColor used for the message in the dialogs
dialogMessageColorDarkColor used for the message in the dialogs in dark mode
dialogRightButtonBackgroundColorColor used for the background in the right button in the dialogs
dialogRightButtonBackgroundColorDarkColor used for the background in the right button in the dialogs for dark mode
dialogRightButtonTextColorColor used for the text in the right button in the dialogs
dialogRightButtonTextColorDarkColor used for the text in the right button in the dialogs for dark mode
dictateIsOnEnables/ the round button in the header to capture expenses via voice (dictation)
docDetectFillUIColorDocument detection rectangle fill color
docDetectFillUIColorDarkDocument detection rectangle fill color for dark mode
docDetectStrokeUIColorDocument detection rectangle stroke color
docDetectStrokeUIColorDarkDocument detection rectangle stroke color for dark mode
documentTypesList of document types to collect, with a user selection to switch between specified types
documentTypesTextColorColor used for the text in the document type selected
documentTypesTextColorDarkColor used for the text in the document type selected for dark mode
emailCCDomainDomain name used to power emailed documents
emailCCIsOnEnables the email CC view inside settings
enableScreenshotsEnables taking screenshots to the camera screen
externalIdAdd a unique reference identifier for a scan, allowing you to easily map the document back to your system
fontAllows the use of a custom font in the lens
forceLandscapeImageForces horizontal preview of checks
fraudDetectionIsOnEnable or disable the ability to recognize a picture of a document displayed on a screen, which may indicate fraud
galleryDocumentDetectorIsOnEnables the document detector option for gallery images
galleryIconEnable or disable the gallery icon
galleryIsOnEnable or disable the photo gallery feature
galleryMultipleSelectionIsOnEnable or disable the option to select multiple images from the gallery
galleryOtherIsOnEnable or disable the option to use the gallery for other document type
glareDetectionIsOnEnable or disable the ability to detect glare in captured images
gpuIsOnEnable or disable machine learning models acceleration
gridIsOnEnables grid in camera to improve visual cues during document scan
gridStrokeColorColor used on camera grid when gridIsOn setting is enabled
highQualityThumbnailScales x2 local generated thumbnail
ignoreRemoteSettingsUsed to test local development settings
isProductionToggle the Is Production setting to enable or disable the use of the production API
isReimbursableDefaultEnables reimbursable option for documents
locationServicesIsOnEnable or disable location services for capturing the user's latitude and longitude
manualCropIsOnEnable or disable the option to manually crop an image before submitting it for processing
moreMenuIsOnEnable or disable the 3-dots 'More' menu
moreSettingsMenuIsOnEnables/disables the Settings option in the 'More' menu
multipleDocumentsIsOnEnable or disable processing multiple stitched images as separate transactions
multiplePagesCaptureIsOnIf enabled, it will detected and process multiple documents in the same scan
noCompressOnWifiWhen enabled bypasses the compress size of uploaded images to send them full size but only during wifi connection
notificationChannelNameSets the name of the notification channel used for uploading files for processing
ocrRegexSpecifies the expected character patterns for local OCR auto-capture
ocrViewCornerRadiusUse the Ocr Corner Radius setting to adjust the radius of the OCR view mask
ocrViewHeightAdjust the Ocr View Height setting to modify the height of the OCR view mask
ocrViewWidthAdjust the Ocr View Width setting to modify the width of the OCR view mask
originalImageMaxSizeInMBSet the maximum size in MB for produced images
packageMaxScansNumber used to set the maximum scans allowed
parseAddressIsOnEnable to receive the vendor.parsed_address response, which contains a breakdown of the vendor address
pdfEditIsOnEnable or disable the Rotate and Crop action if the document is a PDF
pdfFormatIsOnGenerates the PDF with a white background
pdfMaxSizeInMBMaximum size allowed for PDF upload
pdfPreviewIsOnEnable or disable the ability to preview PDFs before submitting
primaryColorMain color used by material design
primaryDarkColorMain dark color used by material design
returnStitchedPDFEnable to receive the file path of a stitched PDF when multiple images are combined into a single document
rotateDocIsOnEnable or disable the option to rotate a document by 90 degrees clockwise
saveLogsIsOnEnable to store logs on the device
secondaryColorSpecifies the accent color displayed in the app
secondaryDarkColorSpecifies the accent color displayed in the app in dark mode
shareLogsIsOnEnables an option on the preview screen to share the logs for debugging
showDocumentTypesWhen disabled, all documents will be treated as either a receipt, invoice or bill
showGuideCounterDetermines the number of times the long receipt tour guide is displayed
showInfoButtonShows and alters menu options in camera allowing to display custom view on info button
showLCDIsNotAllowedEnable to lock scans taken from LCD screens
showNoDocumentDetectedWarningShow or hide a warning on the confirmation screen when Lens cannot detect a document in the image
showStitchCounterNumberShows a small badge in scans right preview views with the current scan count
showStitchPreviewShows a preview of current scans and allows going back to submit screen
singleScanPackagesIf enabled will treat each scan as an independent document
softBinarizationIsOnEnables a filter option that improve on documents scanned with low natural light
stitchedPDFPixelDensityMultiplierMultiplier for the image resolution being drawn on the PDF
stitchIsOnToggle the ability to combine multiple receipts into a single PDF
stitchOtherIsOnEnable or disable the Stitch button in the Other document type
stitchTitleIsOnEnable or disable the option to display the stitch button as a text format
submitButtonBackgroundColorSpecifies the background color of the submit button
submitButtonBackgroundColorDarkSpecifies the background color of the submit button for dark mode
submitButtonBorderColorSpecifies the color of the submit button's border
submitButtonBorderColorDarkSpecifies the color of the submit button's border for dark mode
submitButtonCornerRadiusNumber used to set submit button corner radius
submitButtonFontColorSpecifies the color of the text displayed on the submit button
submitButtonFontColorDarkSpecifies the color of the text displayed on the submit button for dark mode
submitWithoutCloseKeeps alive the submit screen for custom actions while processing
swapAlertActionsIf enabled swaps native alert actions
switchCameraIsOnAllows scanning with front camera
tagsOptional list of custom tags for Veryfi to use in tagging submitted documents
textFontFont for regular body text in lens UI
titleFontFont for titles in Lens UI
toolbarIconsColorThe color used for the icons in the toolbar
toolbarIconsDarkColorThe color used in dark mode for the icons in the toolbar
tryAgainLightIsOnAllows to retry blurred images with the flashlight turned on
undoIsOnAllows to undo/redo the image auto-cropping
usesAlternativeOCRModelEnables use of alternative OCR model
webhookIsOnAllows async document upload by not waiting during processing but listening for the webhook configured in the api web hub
zoomIsOnEnables/disables the option to zoom in/out

Alert Customization (iOS only)​

alertBackgroundColor​

Defines background color of custom alerts (default: #B9BDB1FF)

alertBackgroundDarkColor​

Defines background color of custom alerts for dark mode (default: #B9BDB1FF)

alertFontColor​

Defines font color of custom alerts (default: #000000)

alertFontDarkColor​

Defines font color of custom alerts for dark mode (default: #000000)

alertButtonHeight​

Height value for custom alert CTA button (default: 50.0)

alertButtonCornerRadius​

Corner radius value for custom alert CTA button (default: 12.0)

alertContentMargins​

Controls the content margins of custom alerts (default: 20.0)

alertContentSpacing​

Controls the content spacing of custom alerts (default: -1.0)

alertSheetStyleIsOn​

If disabled makes default sheet alerts display as regular alerts (default: true)

swapAlertActions​

If enabled swaps native alert actions (buttons positions) (default: false)

General Settings​

autoDeleteLocalResourcesAfterProcessing​

Automatically delete the documents saved locally (default: true)



backupDocsToGallery​

Uses photo gallery to back up each scan -- Must ask user for permission (default: true)



checkSequenceMode (Veryfi Lens for Checks only)​

Alternative experience of scanning checks both front and back sides in two steps is false by default



checksBackIsOn (Veryfi Lens for Checks only)​

Toggle Checks Back to enable or disable the capture of the back side of checks after the front side has been taken. This setting helps streamline the check processing workflow within your app, ensuring all necessary information is captured for both sides of the check.



checksBackIsRequired (Veryfi Lens for Checks only)​

Enable this setting to require users to capture the back side of checks after the front side has been taken. This setting helps to ensure the capture of both sides of the check. (default: false)



closeCameraOnSubmit​

By enabling Close Camera On Submit (default: true), the Lens camera view will automatically close after a user submits an image, returning them to the host application for a streamlined user experience.



customLensStrings (iOS only)​

Customize localizable strings in lens UI by setting a key:value object of type [String: [String: String]] where the first key is the language code an the child object key is the current string to replace and the value is the new string to use. All visible strings in the UI are customizable.


Changing string `Try again` in English to `Retry`
settings.customLensStrings = [
    "en": [
        "Try again": "Retry",
        // Add more strings
    ],
    // Add more languages
]


defaultSelectedDocumentType​

Allows selection of the default document type (default: null)

info

If defaultSelectedDocumentType is null, the selected document type is the last one selected by the user.


deviceUserUuid​

Allow passing the UUID4 of our customer's unique user login (default: "")


documentTypes​

This setting is only available when showDocumentTypes is set to true. List of document types to collect, with a user selection to switch between specified types. Allowed values are:


long_receipt - allows user to capture a long receipt by scanning it from top to bottom. Multiple frames are captured and stitched together, similar to a panorama photo, except in vertical orientation
receipt - standard camera experience, whereby documents will be detected as either a receipt or an invoice
bill - standard camera experience, documents will be marked as bill
credit_card - standard camera experience, will read details from credit cards
other - standard camera experience. Only OCR processing is performed on the document, no field extraction is performed
business_card - standard camera experience, will extract data from business cards or document with similar sizes like passport, national document (Limited support at the moment)
check - offers a landscape orientation in the camera and scan checks
code - extracts data from promo codes
w2 - scans w2 tax forms
w9 - scans w9 tax forms
barcode - extracts data locally of most common barcode types
bank_statement - extracts data of bank statements
insurance_card - extracts data of insurance cards
passport - extracts data of passports
driver_license - extracts data of drive licenses
nutrition_fact - extracts data of nutritions facts

font​

Allows the use of a custom font in the lens (default: "")

Note: For iOS you can use both font name with extension or without extension, but for Android you'll have to use the font name with the extension ie. 
iOS: "OpenSans-Bold.ttf" or "OpenSans-Bold"
Android: "OpenSans-Bold.ttf"

Add the Font File to Your Xcode Project​

To add a font file to your Xcode project, select File > Add Files to "Your Project Name" from the menu bar, or drag the file from Finder and drop it into your Xcode project. Also, make sure the font file is a target member of your app; otherwise, the font file will not be distributed as part of your app.


info

You can add True Type Font (.ttf) and Open Type Font (.otf) files.


Register Your Font File with iOS​

After adding the font file to your project, you need to let iOS know about the font. To do this, add the key "Fonts provided by application" to Info.plist (the raw key name is UIAppFonts). Xcode creates an array value for the key; add the name of the font file as an item of the array. Be sure to include the file extension as part of the name.



Set the custom font in VeryfiLensSettings​

let settings = VeryfiLensSettings(with: jsonSettings)
settings.documentTypes = ["receipt", "bill"]
settings.showDocumentTypes = true
settings.font = "CustomFont.ttf"

buttonFont​

Sets the font for buttons (default: "")



textFont​

Sets the font for regular body text content (default: "")



titleFont​

Sets the font for titles (default: "")



buttonFontSize​

Font size for buttons in preview and similar screens



buttonFullWidth​

Make scan preview button to fill the whole available horizontal space



buttonHeight​

Controls the height of scan preview button (iOS uses points and Android uses dp for this value, so they may differ visually with the same value)



buttonHorizontalPadding​

Adds horizontal spacing of scan preview button when in full width



buttonTopPadding​

Adds top spacing to scan preview button



fraudDetectionIsOn​

Toggle Fraud Detection to enable or disable the ability to recognize a picture of a document displayed on a screen, which may indicate fraud. Use this setting to help ensure that only real, physical documents are processed within your app, improving overall data accuracy and integrity.



locationServicesIsOn​

Toggle Location Services to enable or disable location services for capturing the user's latitude and longitude (default: true). This provides additional context for document processing when location data is relevant to your app's requirements.



notificationChannelName (Android Only)​

Sets the name of the notification channel used for uploading files for processing (default: veryfi_channel_notification)



originalImageMaxSizeInMB​

Configure the Original Image Max Size In Mb setting to set the maximum size in MB for produced images (default: 2.5). The valid range is 0.2 to 2.5 MB, allowing you to optimize image quality and file size based on your app's requirements.



returnStitchedPDF​

Enable Return Stitched PDF to receive the file path of a stitched PDF in the veryfiLensUpdate delegate function when multiple images are combined into a single document (default: false). This facilitates easier access and management of merged documents within your application.



saveLogsIsOn​

Enable the Save Logs setting to store logs on the device, which is recommended for aiding with debugging if needed (default: true). This feature helps identify issues and improve app performance during development and maintenance.



showNoDocumentDetectedWarning​

Allows to show or hide a warning on the confirmation screen when Lens cannot detect a document in the image. (default: true)



showGuideCounter (Veryfi Lens for Long receipt only)​

Determines the number of times the long receipt tour guide is displayed (default: 0)



stitchedPDFPixelDensityMultiplier​

Multiplier for the image resolution being drawn on the PDF. Valid range is: 1.0 to 5.0 (default: 2.0)



enableScreenshots​

Enables taking screenshots to the camera screen (default: true)



Camera Customization​

autoCaptureFrameConfidence​

By default it process 10 frames before triggering auto capture, the greater the value, the slower the auto capture speed



autoCaptureMarginRatio​

Increases or reduces the capture region margin during auto-capture, forcing the document to be at a certain distance from the edges. Valid range is: 0.0 to 0.1 (default: 0.0)



autoCaptureIsOn​

Enable Auto Capture to allow the app to automatically capture the document, selecting the best frame for optimal image quality and processing. This feature simplifies the user experience and enhances document capture accuracy (default: false).

info

Disabling auto-capture for credit cards is not recommended as it ensures accurate information extraction.



autoCaptureOtherIsOn​

Enable Auto Capture to allow the app to automatically capture the document for Other document type, selecting the best frame for optimal image quality and processing. This feature simplifies the user experience and enhances document capture accuracy (default: false).

info

Disabling auto-capture for credit cards is not recommended as it ensures accurate information extraction.



autoDocDetectionAndCropIsOn​

Enable Auto Doc Detection And Crop to automatically detect, highlight, and crop documents during camera image capture (default: true). When set to false, the green detection box won't be displayed, and the image won't be cropped.



autoLightDetectionIsOn​

Control the automatic illumination of documents by enabling or disabling the Auto Light Detection feature. When set to true, the SDK intelligently adjusts the lighting to optimize document visibility. For manual control, turn this setting ON (default: false).



browseOtherIsOn​

Enable or disable the Browse option for the other document type. (default: false)



galleryIcon​

Enable or disable the gallery icon. (default: false)



galleryIsOn​

Toggle Gallery in the Lens SDK to enable or disable the photo gallery feature. By default, this option is enabled (true), which means that users can access their device's photo gallery from the camera screen to select an existing photo to process.



galleryMultipleSelectionIsOn​

Enable or disable the option to select multiple images from the gallery. (default: false)



galleryOtherIsOn​

Enable or disable the option to use the gallery for other document type. (default: true)



moreMenuIsOn​

Toggle More Menu in the Lens SDK to enable or disable the showing of the more menu. By default, this option is enabled (true), which means that users can access the more menu by tapping the "Three Dots" button in the camera screen.



multiplePagesCaptureIsOn​

If enabled, it will detected and process multiple documents in the same scan. (default: true)



singleScanPackages​

If enabled, it will send each scan as an individual package/document. (this only applies if stitchIsOn and multipleDocumentsIsOn)



If enabled, it will detected and process multiple documents in the same scan. (default: true)

ocrViewHeight (Veryfi Lens for OCR only)​

Adjust the Ocr View Height setting to modify the height of the OCR view mask (default: 8). This customization allows you to better fit the capture area within your app's design and provide a more consistent user experience.



ocrViewWidth (Veryfi Lens for OCR only)​

Configure the Ocr View Width setting to modify the width of the OCR view mask (default: 85). This customization allows you to better fit the capture area within your app's design and provide a more consistent user experience.



ocrViewCornerRadius (Veryfi Lens for OCR only)​

Use the Ocr Corner Radius setting to adjust the radius of the OCR view mask, allowing you to customize the appearance of the capture area to better match your app's design and provide a more consistent user experience.



showDocumentTypes​

When disabled, the default camera experience will be used and all documents will be treated as either a receipt, invoice or bill (auto-detected) (default: false)



showInfoButton​

Shows and alters menu options in camera allowing to display custom view on info button. (default: null)



tryAgainLightIsOn​

Allows to retry blurred images with the flashlight turned on. (default: false)



zoomIsOn​

Enables/disables the option to zoom in/out in a range 1-2



noCompressOnWifi​

When enabled bypasses the compress size of uploaded images to send them full size but only during wifi connection (default: false)



afterScanCloseCameraIsOn​

Enables a menu option in camera settings, so that users can decide whether to close the camera after scanning a document. (default: true)



browseIsOn​

Use the Browse setting to enable or disable the ability for users to browse documents using the iPhone's Files app (default: true). Customize this feature according to your app's specific document management requirements.



browseDocumentDetectorIsOn​

Enables the document detector option for the file browser (default: true).



galleryDocumentDetectorIsOn​

Enables the document detector option for gallery images (default: true).



moreSettingsMenuIsOn​

Enables/disables the showing of the More > Settings option. NOTE: When this is FALSE all Settings come from the app, not the user (default: true)



packageMaxScans​

Number used to set the maximum scans allowed. 10 is the maximum per session. (default: 4)



Document Preview Customization​

autoSubmitDocumentOnCapture​

Activate this setting to skip Document Preview screen and send the scanned document just right after capture (default" false)



allowSubmitLowQualityDocsIsOn (Android Only)​

Allows low quality images to be uploaded (default: true).



allowSubmitUndetectedDocsIsOn​

Activate this setting to require users to capture only valid receipts, preventing submission of unrelated images like animals or selfies (default: true).



blurDetectionInAutoCaptureIsOn​

Is disabled by default, if enabled it will check for blur after auto capture is finished



blurDetectionIsOn​

Enable blurDetectionIsOn to check if a captured picture has 20% or more blur (default: true). Blurred receipts may not process well. When set to true, an alert message will be shown to the user, indicating that the image is blurred and may need to be recaptured for better processing.



glareDetectionIsOn​

Toggle Glare Detection to enable or disable the ability to detect glare in captured images. When set to true, this feature helps ensure better image quality by alerting the user to adjust their position or lighting to reduce glare, resulting in clearer and more readable document captures. (default: true)



backupDocsToiCloud (iOS Only)​

Allows backing up scanned images in iCloud Documents folder

For this setting to work you need the iCloud configuration steps in your own app

#1. In your Target go to Signing & Capabilities -> Add iCloud Capability -> In Services check iCloud Documents and add your container (usually `iCloud.YOUR_BUNDLE_ID)


#2. Add this at the end of your Info plist file
<key>NSUbiquitousContainers</key>
    <dict>
        <key>YOUR-CONTAINER-NAME</key>
        <dict>
            <key>NSUbiquitousContainerIsDocumentScopePublic</key>
            <true/>
            <key>NSUbiquitousContainerName</key>
            <string>YOUR-BUNDLE-ID</string>
            <key>NSUbiquitousContainerSupportedFolderLevels</key>
            <string>Any</string>
        </dict>
    </dict>

before the last enclosing keys

</dict></plist>


switchCameraIsOn​

Allows scanning with front camera



showStitchCounterNumber​

Shows a small badge in scans right preview views with the current scan count



showStitchPreview​

Shows a preview of current scans and allows going back to submit screen



manualCropIsOn​

Toggle Manual Crop in the Lens SDK to enable or disable the option to manually crop an image before submitting it for processing. By default, this option is enabled (true), which means that users can manually crop the image they capture before submitting it.



multipleDocumentsIsOn​

Use the Multiple Documents setting to enable or disable processing multiple stitched images as separate transactions (default: false). Note that this feature requires stitchIsOn to be enabled. Adjust this setting according to your app's transaction management needs.



pdfEditIsOn​

Enable or disable the Rotate and Crop action if the document is a PDF. (default: true)



pdfFormatIsOn​

Generates the PDF with a white background. (default: true)

pdfMaxSizeInMB​

Maximum size allowed for PDF upload in MB. (default: 10)

pdfPreviewIsOn​

Enable or disable the ability to preview PDFs before submitting. (default: false)



rotateDocIsOn​

Toggle Rotate Doc to enable or disable the option to rotate a document by 90 degrees clockwise on each press (default: true).



stitchIsOn​

Toggle the ability to combine multiple receipts into a single PDF with our Stitch feature (default: true).



stitchOtherIsOn​

Enable or disable the Stitch button in the Other document type. (default: false)



stitchTitleIsOn​

Enable or disable the option to display the stitch button as a text format. (default: false)



shareLogsIsOn​

Enables an option on the preview screen to share the logs for debugging. Recommended to be disabled in production (default: false)



undoIsOn​

Allows to undo/redo the image auto-cropping (default: true)



Image Processing Settings​

autoRotateIsOn​

Enable the Auto Rotate setting to automatically rotate captured images, ensuring the contained document is correctly oriented (default: false). This feature enhances image readability and improves document processing accuracy.



autoSkewCorrectionIsOn​

Enable Auto Skew Correction to automatically correct image skewing during the capture process. This feature helps ensure that documents are properly aligned and oriented, resulting in improved readability and processing accuracy (default: true).

Note: This setting only works if autoRotateIsOn is set to false



autoCropGalleryIsOn​

Enable Auto Crop Gallery to apply document detection and auto-cropping on documents imported from the image gallery (default: false). This feature ensures consistent image quality and processing efficiency for both camera-captured and gallery-imported images.



autoCropBrowserIsOn​

Enable Auto Crop Browser to apply document detection and auto-cropping on documents imported from the file browser (default: false). This feature ensures consistent image quality and processing efficiency for both camera-captured and gallery-imported images.



cleanBorderIsOn​

Toggle Clean Border to enable or disable the clean-borders post-processing feature. This setting helps refine the appearance of document edges after capture, resulting in a cleaner and more professional-looking final image (default: false).



dewarpingIsOn​

Enable Dewarping to activate or deactivate the dewarping algorithm, which corrects image distortion. When set to true, be aware that it may add some seconds to the image processing time, but the result will be a more accurate and visually appealing document.



gpuIsOn​

Toggle Gpu to enable or disable machine learning models acceleration. While using the GPU can speed up model processing, it may also consume more resources and drain the battery faster. Adjust this setting based on your app's performance and resource requirements.

info

  • GPU Compatibility in Machine Learning Models
    Our Machine Learning (ML) models are not universally compatible with all Android device GPUs. The diversity in hardware across the GPU market means that not every chip can support the full range of ML operations. To ensure optimal performance and prevent undesirable behavior, our Lens SDK maintains an internal blacklist of devices that are known to have compatibility issues with GPU-accelerated features.

  • Behavior on Blacklisted Devices
    If a device is on the blacklist, even if GPU settings are enabled, the ML models will not utilize the GPU. Instead, processing will automatically revert to the CPU. This switch ensures stability and performance integrity.

  • Updating the Blacklist
    We continuously refine and update the blacklist to cover any new devices that might exhibit compatibility issues. If you encounter any problems running our ML models with GPU acceleration enabled, please contact us. Provide details about the issue and your device model so we can investigate and update our blacklist appropriately.



forceLandscapeImage​

Forces horizontal preview of checks (default: false)

highQualityThumbnail​

Scales x2 local generated thumbnail (default: false)



softBinarizationIsOn​

Enables a filter option that improve on documents scanned with low natural light. (default: false)

Note: The filter will only be applied to images selected from the gallery if the autoCropGalleryIsOn option is enabled.



showLCDIsNotAllowed​

Enable to lock scans taken from LCD screens. (default: false)



submitWithoutClose​

Keeps alive the submit screen for custom actions while processing and notifies a new update event in delegate update responses

{
  "status" : "update",
  "msg" : "submit_without_close"
}


usesAlternativeOCRModel​

Enables use of alternative OCR model (default: false)



Colors Customization​

accentColor (Android Only)​

Accent color used by material design (default: "#005AC1")



accentDarkColor (Android Only)​

Accent dark color used by material design (default: "#DBE2F9")



backgroundColorConfirmationScreen​

The color setting specifies the background color displayed on the Confirmation Screen.

Default: #F2F2F71



backgroundDarkColorConfirmationScreen (Android only)​

The color setting specifies the background color displayed on the Confirmation Screen for dark mode.

Default: #000000



docDetectFillUIColor​

Document detection rectangle fill color. Android Opacity is controlled by the first two letters (default: "#9653BF8A")



docDetectFillUIColorDark (Android only)​

Document detection rectangle fill color for dark mode. Android Opacity is controlled by the first two letters (default: "#9653BF8A")



docDetectStrokeUIColor​

Document detection rectangle stroke color (default: null)



docDetectStrokeUIColorDark (Android only)​

Document detection rectangle stroke color for dark mode (default: null)



documentTypesTextColor (Android only)​

Color used for the text in the document type selected



documentTypesTextColorDark (Android only)​

Color used for the text in the document type selected for dark mode



dialogMessageColor (Android only)​

Color used for the message in the dialogs



dialogMessageColorDark (Android only)​

Color used for the message in the dialogs in dark mode



dialogRightButtonTextColor (Android only)​

Color used for the text in the right button in the dialogs



dialogRightButtonTextColorDark (Android only)​

Color used for the text in the right button in the dialogs for dark mode



dialogRightButtonBackgroundColor (Android only)​

Color used for the background in the right button in the dialogs



dialogRightButtonBackgroundColorDark (Android only)​

Color used for the background in the right button in the dialogs for dark mode



dialogLeftButtonTextColor (Android only)​

Color used for the text in the left button in the dialogs



dialogLeftButtonTextColorDark (Android only)​

Color used for the text in the left button in the dialogs for dark mode



primaryColor (Android Only)​

Main color used by material design (default: "#4285f4")



primaryDarkColor (Android Only)​

Main dark color used by material design (default: "#ADC6FF")



secondaryColor​

iOS: The secondary color setting specifies the accent color displayed in the app. By default, the color is black. (default: "#000000") Android: The secondary color used by material design (default: "#DBE2F9")



secondaryDarkColor​

iOS: The secondary dark color setting specifies the accent color displayed in the app in dark mode. By default, the color is White. (default: "#FFFFFF") Android: The secondary dark color used by material design (default: "#3F4759")



submitButtonBackgroundColor​

The Submit Button Background Color setting in the Lens SDK specifies the background color of the submit button. By default, the submit button has a background color of #005AC1.



submitButtonBackgroundColorDark (Android only)​

The Submit Button Background Color setting in the Lens SDK specifies the background color of the submit button for dark mode. By default, the submit button has a background color of #005AC1.



submitButtonBorderColor​

The Submit Button Border Color setting in the Lens SDK determines the color of the submit button's border. By default, the submit button has a border color of #005AC1.



submitButtonBorderColorDark (Android only)​

The Submit Button Border Color setting in the Lens SDK determines the color of the submit button's border for dark mode. By default, the submit button has a border color of #005AC1.



submitButtonFontColor​

The Submit Button Font Color setting in the Lens SDK specifies the color of the text displayed on the submit button. By default, the text color is set to #FFFFFF, which is white.



submitButtonFontColorDark (Android only)​

The Submit Button Font Color setting in the Lens SDK specifies the color of the text displayed on the submit button for dark mode. By default, the text color is set to #FFFFFF, which is white.



submitButtonCornerRadius​

Number used to set submit button corner radius (default: 30)



toolbarIconsColor​

iOS: This is the color used for the icons in the toolbar. By default, the color is White. (default: "#FFFFFF") Android: This is the color used for the icons in the toolbar.



toolbarIconsDarkColor​

iOS: This is the color used in dark mode for the icons in the toolbar. By default, the color is Black. (default: "#000000") Android: This is the color used in dark mode for the icons in the toolbar.



gridIsOn (iOS only)​

Enables grid in camera to improve visual cues during document scan



gridStrokeColor (iOS only)​

Color used camera grid when gridIsOn setting is enabled



dictateIsOn​

Enables the round button in the header to capture expenses via voice (dictation) (default: true)



emailCCIsOn​

Enables the email CC view inside settings (default: true)



emailCCDomain​

Domain name used to power emailed documents



Data Extraction Settings​

autoTagSource​

Toggle the Auto Tag Source setting to tag automatically document sources (gallery, browse, camera) (default: false).



autoTagDeviceId​

Toggle the Auto Tag Device Id setting (default: false).



autoTagLensVersion​

Toggle the Auto Tag Lens Version setting (default: false).



autoTagPlatform​

Toggle the Auto Tag Platform setting (iOS or Android) (default: false).



anyDocumentTemplate​

Picks which document template will be used for any_document data extraction. Currently supported auto_insurance_card, bill_of_lading, flight_itinerary, goods_received_note, incorporation_document, incorporation_document_latam, indian_passport, latam_passport, prescription_medication_label, product_nutrition_facts, restaurant_menu, shipping_label, uk_drivers_license, us_driver_license, us_health_insurance_card, us_passport, vehicle_registration, vendor_statement, work_order. (default: "")



anyDocumentType​

Takes a string that extracts data on any of the supported documents. Currently supported ine, passport, colombian_id. (default: "")



cameraProcessingMode​

Specifies the scanning mode in camera between document and card modes. This setting is only valid when using any_document type in documentTypes. (default: document)



appVersion​

Specifies the version string of the Lens SDK client app (default: null).



barcodeExtractionIsOn​

Toggle the Barcode Extraction setting to enable or disable barcode extraction (default: false). This feature allows your app to extract information from barcodes found on documents.



boundingBoxesIsOn​

Enable the Bounding Boxes setting to return the coordinates for the location of fields on the document (default: false).



confidenceDetailsIsOn​

Enable the Confidence Details setting to receive additional information about the confidence level of the inference (default: false).



dataExtractionEngine​

Configure whether a document should be sent to the server or if the whole processing should be done locally. the available values are 0 = cloud processing and 1 = in-app processing, some document types like code or barcode only support in-app processing at the moment (default: 0)

Wrappers​

Available values for wrappers should be strings like: mobile, api and none

    "mobile" -> veryfiLensSettings.dataExtractionEngine = ExtractionEngine.VeryfiInApp
    "api" -> veryfiLensSettings.dataExtractionEngine = ExtractionEngine.VeryfiCloudAPI
    "none" -> veryfiLensSettings.dataExtractionEngine = ExtractionEngine.None



detectBlurResponseIsOn​

Toggle the Detect Blur Response setting to enable or disable the is_blurry response, which represents the model's assessment of whether the document is blurred or not (default: false).



ocrRegex (Veryfi Lens OCR only)​

Use the Ocr Regex setting to specify the expected character patterns for local OCR auto-capture. This regular expression helps the OCR system better identify and capture relevant information, resulting in more accurate and efficient document processing.



parseAddressIsOn​

Enable the Parse Address setting to receive the vendor.parsed_address response, which contains a breakdown of the vendor address into its components, such as street address, postcode, country, etc. (default: false).



externalId​

Use the External Id setting to add a unique reference identifier for a scan, allowing you to easily map the document back to your system. This pass-through field helps maintain a clear relationship between the captured documents and their corresponding records in your own database or system.



categories​

Optional list of custom categories for Veryfi to use in categorizing submitted documents (default: null)



tags​

Optional list of custom tags for Veryfi to use in tagging submitted documents (default: null)



API Settings​

autoDeleteAfterProcessing​

Enable the Auto Delete After Processing setting to automatically delete documents from the server once they have been processed.



boostModeIsOn​

Toggle the Boost Mode setting to enable or disable boost mode (default: false). When enabled, boost mode increases the processing speed of documents within the app, providing a faster and more efficient user experience.



computeIsOn​

Toggle the Compute flag to enrich document extraction for certain fields, it is on by default. See more in FAQs



isProduction​

Toggle the Is Production setting to enable or disable the use of the production API (default: true).



isReimbursableDefault​

Enables reimbursable option for documents (default: false)



ignoreRemoteSettings​

When this setting is enabled, ignores settings handled by the server (default: false)


Note: It's highly recommended that this value stays *false* for production environments, turn this on only for your local development uses

webhookIsOn​

Allows async document upload by not waiting during processing but listening for the webhook configured in the api web hub(default: false)



Veryfi Lens for Credit Card Settings​

creditCardDetectorCardNumber (Veryfi Lens for Credit Cards only)​

Configure if the scanner should detect the credit card number (default: true)



creditCardDetectorCardHolderName (Veryfi Lens for Credit Cards only) {creditcarddetectorcardholdername}​

Configure if the scanner should detect the credit card holder's name (default: true)



creditCardDetectorCardCVC (Veryfi Lens for Credit Cards only)​

Configure if the scanner should detect the credit card CVC (default: true)



creditCardDetectorCardDate (Veryfi Lens for Credit Cards only)​

Configure if the scanner should detect the credit card date (default: true)



creditCardAutoCaptureMode (Veryfi Lens for Credit Cards only)​

Configures the credit card capture mode, allowing to prioritize speed, accuracy or normal (default: normal)



creditCardMarginTop (Veryfi Lens for Credit Cards only)​

Credit card's top margin (default: 100)



creditCardMarginBottom (Veryfi Lens for Credit Cards only)​

Credit card's bottom margin (default: 0)