Skip to main content

Web

v7.6.3​

Improvements​

  • Improved automatic lightweight build detection for mobile devices
    • Now uses Device Memory API to detect low-memory devices (< 4GB)
    • Applies to all mobile devices (phones and tablets) with available memory information
    • Falls back to undefined when memory information is unavailable, allowing manual configuration
    • Previously used a simple user agent check for all mobile devices
  • Updated the camera picking logic
  • Improved error handling on the Camera class

7.6.2​

Bugfixes​

  • Fixes microblinkProxyUrl handling
    • Prevent an extra ping to the Microblink server when a proxy URL is configured (previously one redundant request was sent).
    • Preserve the user-provided path when using a proxy URL (previously the path was removed).

7.6.1​

What's New​

  • For some documents, the document type was returned as none, which was causing confusion. To prevent this, we are filling in the document type from the barcode in case customers are using barcode-id mode.
  • The fix is applied to all the AAMVA types, plus some others (Argentina, Canada, Colombia, Nigeria, Panama, Paraguay, SouthAfrica).

v7.6.0​

What's New​

  • We introduced event tracking across the SDK lifecycle, giving you deeper insights into user journeys, success rates, and drop-off points during scanning sessions. These enhanced analytics make it easier to identify optimization opportunities and ensure the best possible user experience.
  • Updated detection analysis logic in case of photo mode
  • Added support for capturing the back of US passports that feature a barcode
  • Unparsable barcodes no longer prevent the scanning process from finishing and will be returned as raw data in the result if the recognitionModeFilter is set to enableFullDocumentRecognition. Using enableBarcodeId still requires the barcode to be parsable in order to successfully finish the scanning process
  • Added a new parsed property on the barcode property of the SingleSideScanningResult which indicates if the raw barcode data was successfully parsed into structured information.
  • Improved visual clarity and of feedback UI elements
  • Added a new UI state MOVE_LAST_PAGE for Indian passports and applicable US passports, as well as the accompanying UI feedback message in @microblink/blinkid-ux-manager.
  • Renamed #handleUiStateChanges method to #updateUiStateFromProcessResult
  • Added missing showHelpTooltipTimeout option to the FeedbackUiOptions
  • Added haptic feedback on supported devices
  • Added translation files in @microblink/camera-manager and @microblink/blinkid-ux-manager for 33 new languages

Bugfixes​

  • Fixed the issue with scanning the back of the Essad Card which was causing only Date of Expiry to be extracted

  • Fixed the issue with additionalNameInformation extraction for France ID and Residence Permit

  • Prevent parsing of two-line MRZ in TD1 format unless it's explicitly allowed. This will prevent false positive MRZ extraction on documents where the last line of the MRZ is covered or not fully visible

  • Users are no longer forced to scan back sides of Alien and Refugee passports

  • Fixed the issue with Togo ID where document number from VIZ was overriden by a wrong value from MRZ

  • Various other minor bug fixes and cleanups

New Documents Support​

  • Angola - Paper Passport
  • Bahrain - Polycarbonate Passport
  • Burkina Faso - Polycarbonate Passport
  • Cameroon - Driver's License
  • Canada, Manitoba - Metis Federation Card
  • East Timor - Polycarbonate Passport
  • El Salvador - Paper Passport
  • Eritrea - Paper Passport
  • France - Adr Certificate
  • Germany - Adr Certificate
  • Ghana - Voter ID
  • India, Telangana - Driver's License
  • Ivory Coast - Paper Passport
  • Japan - Polycarbonate Passport
  • Liberia - Paper Passport
  • Liberia - Voter ID
  • Malawi - Identity Card
  • Malawi - Paper Passport
  • Maldives - Polycarbonate Passport
  • Mali - Paper Passport
  • Mauritius - Paper Passport
  • Oman - Vehicle Registration
  • Paraguay - Polycarbonate Passport
  • Rwanda - Driver's License
  • Senegal - Driver's License
  • Sierra Leone - Paper Passport
  • Somalia - Paper Passport
  • Switzerland - Adr Certificate
  • Togo - Driver's License
  • Togo - Paper Passport
  • USA, Maryland - Medical Marijuana ID
  • Vietnam - Paper Passport

New Document Versions for Supported Documents​

  • Chile - Polycarbonate Passport
  • India - Paper Passport
  • Moldova - Identity Card
  • Pakistan - Identity Card
  • Peru - Identity Card
  • Romania - Identity Card
  • Slovakia - Identity Card
  • USA, California - Driver's License
  • USA, California - Identity Card
  • USA, New Hampshire - Identity Card
  • USA, Georgia - Medical Marijuana ID
  • USA, Pennsylvania - Medical Marijuana ID
  • USA, South Carolina - Driver's License
  • USA, South Carolina - Identity Card
  • USA, Texas - Driver's License
  • USA, Texas - Identity Card

New Segments Supported on Documents​

  • Switzerland, Residence Permit - 'dateOfEntry'
  • Hungary, Identity Card - 'maidenName', 'nationality', 'sexOrGender', 'documentNumber', 'dateOfBirth'
  • Greece, Identity Card - 'fathersName' (Latin and Greek), 'mothersName' (Latin and Greek), 'personalIdNumber', 'issuingAuthority' (Greek), 'municipalityOfRegistration' (Greek)
  • Mexico, Voter ID - 'sectionCode', 'stateCode', 'municipalityCode', 'localityCode'
  • Mexico, Consular Voter ID - 'stateCode', 'stateName'

Renamed segments​

  • Hungary - Identity Card - additionalNameInformation -> mothersName

v7.4.3​

Bug Fixes​

  • Fixed types

v7.4.2​

What's New​

  • Improved loadBlinkIdCore() callback. loadProgress is now called even when resources response does not have Content-Length header
  • BlinkIdUxManager will now clear session object on DOCUMENT_CAPTURED event
  • Added 2 new methods getSessionResult and safelyDeleteScanningSession to BlinkIdUxManager
  • blinkid-wasm package now provides size manifests for resource files
  • Reduced the default resolution to 1080p
  • Preferred camera resolution can now be set through CameraManager constructor
  • Improved blinkid-ui-customization example

Bug Fixes​

  • Fixed issue with some iPhonePro devices where rotating device would affect scanning
  • Fixed small memory leak happening while creating user agent string

v7.4.1​

What's New​

  • Exposed addDocumentClassFilter and addOnDocumentFilteredCallback on the BlinkIdComponent type
  • Enhanced reset session behaviour in BlinkIdUxManager
  • Enhance BlinkIdFeedbackUi with modal visibility controls
  • Add camera error modal visibility control
  • Enhance error handling in BlinkIdWorker

Bug Fixes​

  • Fixed issue where ErrorModal would not close in some cases.
  • Fixed issue where UI had stale state after session restart.

v7.4.0​

What's New​

New Documents Support​

  • Canada, Newfoundland And Labrador - Identity Card
  • Canada, Northwest Territories - Driver's License
  • Canada, Northwest Territories - Identity Card
  • Canada, Prince Edward Island - Identity Card
  • Canada, Yukon - Identity Card

New Document Versions for Supported Documents​

  • Canada, Yukon - Driver's License

Bug Fixes​

  • Fixed build error on Windows devices in monorepo setup
  • Fixed build error with Node.js v24 in monorepo setup

Other​

  • Added API documentation specification

v7.3.2​

What's New​

  • Added utilities for extracting images from BlinkIdScanningResult:
    • extractSideInputImage
    • extractBarcodeImage
    • extractSideDocumentImage
    • extractFaceImage
    • extractSignatureImage

Bug Fixes​

  • Fixed issues where EMBind was configured with invalid property mappings.

v7.3.1​

Fixes​

  • Fixed an issue where the camera failed to start on certain Windows desktop devices.
  • Fixed an issue where BlinkIdModule.worker.mjs was incorrectly requested over the network.

v7.3.0​

What's New​

  • Improved extraction for Canada/Nunavut ID and DL by introducing error correction for "1" and "I" characters which look the same in the font used on a document

Bugfixes​

  • Fixed document number extraction from Canada/Nunavut barcodes
  • Fix for ARGENTINA ID and ALIEN_ID documents - made separate barcode scanning step optional for these documents. They have a barcode on the front side, and requiring barcode extraction was causing the scanning process to get stuck on the front.

New Documents Support​

  • Canada, Nunavut - Driver's License
  • Canada, Nunavut - Identity Card
  • Liberia - Identity Card
  • Mali - Identity Card
  • UK - Military ID

New Document Versions for Supported Documents​

  • Bahrain - Identity Card
  • Canada - Weapon Permit
  • Chile - Alien ID
  • Chile - Identity Card
  • Finland - Driver's License
  • Indonesia - Driver's License
  • Kosovo - Identity Card
  • Latvia - Polycarbonate Passport
  • Mexico, Chiapas - Driver's License
  • Mexico, Ciudad de Mexico - Driver's License
  • Mexico, Durango - Driver's License
  • Mexico, Jalisco - Driver's License
  • Sri Lanka - Driver's License
  • USA, Alaska - Driver's License
  • USA, New Hampshire - Driver's License
  • European Union - Health Insurance Card

New Beta Documents Support​

  • Canada - Non Card Tribal ID
  • Dominica - Paper Passport
  • Dominica - Polycarbonate Passport
  • UAE - Diplomatic ID
  • USA, Georgia - Medical Marijuana ID

New Document Versions for Beta-Supported Documents​

  • Egypt - Driver's License
  • Mexico, Quintana Roo - Driver's License
  • Philippines - Postal ID
  • Vietnam - Identity Card

New Segments Supported on Documents​

  • European Union, Health Insurance Card - countryCode
  • Italy, Identity Card - documentOptionalAdditionalNumber
  • France, Identity Card - additionalNameInformation
  • UK, Asylum Request - residencePermitType, remarks
  • UK, Residence Permit - residencePermitType, remarks, certificateNumber, nationalInsuranceNumber

Renamed segments​

  • Bahrain - Identity Card - documentNumber -> personalIdNumber

Changes inside packages​

@microblink/blinkid-ux-manager​

  • Added showHelpButton property to FeedbackUiOptions for improved UI control.
  • Added part attribute help-button-part to the help button to enable external styling.
  • Added additional control of the help tooltip via setHelpTooltipShowDelay and setHelpTooltipHideDelay methods on the BlinkIdUxManager
  • setTimeoutDuration now defaultly sets setHelpTooltipShowDelay to the 50% duration
  • Updated help tooltip default behaviour

@microblink/blinkid-wasm​

  • Fixed incorrect property name in MrzResult: rawMRZString is now correctly exposed as rawMrzString.
  • Fixed incorrect full-document type document type in ImageExtractionType.
  • Fixed typing issue by correctly adding the vehicleOwner property to BlinkIdScanningResult.
  • Added certificateNumber, countryCode and nationalInsuranceNumber to BlinkIdScanningResult and VizResult types.
  • Added non-card-tribal-id and diplomatic-id to DocumentType
  • This change updates the Emscripten toolchain to version 4.0.9, upgrades multiple C++ package dependencies, and adds new document types (non-card-tribal-id, diplomatic-id) and field types (certificateNumber, countryCode, nationalInsuranceNumber) to the BlinkID recognition system.

@microblink/camera-manager​

  • Enhanced customization capabilities with additional modification options.
  • Added showTorchButton and showCloseButton properties to CameraManagerUiOptions for improved UI control.
  • Added part attribute camera-select-part to the camera select element to enable external styling.
  • Added part attribute video-element-part to the video element to enable external styling.

v7.2.2​

Fixes​

  • Fixed an issue where the SDK failed to initialize properly when resources were hosted on a different origin than the application, which was caused by Web Worker initialization failures.

v7.2.1​

Fixes​

  • Fixed an issue with frame quality estimation that could cause the recognition process to get stuck. This fix significantly improves success rate of document capturing, especially for the desktop cameras

v7.2.0​

What's new​

  • Added the ability to filter documents using the addDocumentClassFilter method on the BlinkID UX Manager.
  • Added new user feedback for scanning multi-page passport documents.
  • Added message for hand occlusion detection. The setting skipImagesOccludedByHand set to true by default
  • Added message for poor lighting conditions detection. The setting skipImagesWithInadequateLightingConditions set to true by default
  • Added "Demo" overlay for the demo licenses (non-production)
  • Added "Powered by Microblink" overlay option for licenses with this enabled

Bug Fixes​

  • Fixed data match bug when partial anonymisation is enabled
  • Fixed face extraction bug for rotated face images on documents
  • Improved face extraction for documents without face image (skipping face image extraction in that case)
  • Fixed face extraction bug for Philippines Passport document
  • Fixed an issue with filling the ProcessResult during the Barcode Capture step, ensuring only relevant fields are filled
  • Fixed bug that forced scanning of the back side of the Germany Residence Permit in passport document
  • Fixed bug that caused skipping back side when only signature was present
  • Fixed an issue which caused certain feedback messages to be displayed too briefly.

v7.1.0​

What's New​

New Documents Support​

  • Austria - Refugee Passport
  • Austria - Polycarbonate Refugee Passport
  • Burkina Faso - Driver's License
  • Burkina Faso - Paper Passport
  • Costa Rica - Residence Permit
  • Gambia - Paper Passport
  • Guinea - Polycarbonate Passport
  • Rwanda - Polycarbonate Passport
  • South Korea - Polycarbonate Passport
  • Tanzania - Polycarbonate Passport
  • Uganda - Paper Passport
  • Uganda - Polycarbonate Passport
  • Zambia - Driver's License
  • Zambia - Paper Passport
  • USA, Florida - Medical Marijuana ID
  • USA, Pennsylvania - - Medical Marijuana ID

New Beta Documents Support​

  • Benin - Paper Passport
  • Burundi - Polycarbonate Passport
  • Chad - Identity Card
  • Kenya - Driver's License
  • Mozambique - Polycarbonate Passport
  • Spain - Registration Certificate
  • Sudan - Identity Card
  • Zimbabwe - Driver's License
  • USA, Nevada - Medical Marijuana ID
  • USA, New York - Medical Marijuana ID
  • USA, Oklahoma - Medical Marijuana ID

New Document Versions for Supported Documents​

  • Bangladesh - Second data page support on Paper Passport and Polycarbonate Passport
  • Kosovo - Paper Passport
  • Mexico, Colima - Driver's License
  • Mexico, Mexico - Driver's License
  • Netherlands - Identity Card
  • Netherlands - Polycarbonate Passport
  • Romania - Identity Card, Back side scanning
  • Romania - Polycarbonate Passport
  • Singapore - Employment Pass, Back side scanning
  • Slovakia - Polycarbonate Passport
  • Syria - Paper Passport
  • USA, Wyoming - Driver's License

New Document Versions for Beta-Supported Documents​

  • Mexico, Guanajuato - Driver's License
  • Mexico, Puebla - Driver's License
  • Croatia - Health Insurance Card

New Segments Supported on Documents​

  • Greece
    • Identity Cards, Driver's Licenses, Residence Permits and Passports
    • expanding support for extracting segments in Greek script
  • Saudi Arabia, Identity Card
    • expanding support for extracting segments in Arabic script
  • Egypt, Driver's Licenses
    • expanding support for extracting segments in Arabic script

v7.0.1​

Fixes​

  • Fixed issues with remote license handling

v7.0.0​

We're excited to introduce BlinkID v7, a major upgrade designed to simplify your integration and deliver a simpler ID scanning experience. With BlinkID v7, we're taking a fresh approach to scanning logic by introducing a more straightforward, session-based API for an easier configuration path, all while boosting first-time scan success rate.

Highlights & Integration Improvements​

  • Unified session-based API: We've moved away from juggling multiple recognizers (e.g., SingleSide, MultiSide) to a single session-based approach, unifying scanning logic under one simplified API. There's no need to switch recognizers anymore.
  • Backward compatibility: Existing production keys will continue to work with v7.0. No new license key is required for the upgrade.
  • More maintainable codebase: This new architecture sets the stage for easier and faster updates.

Architecture Changes​

  • New core components: Instead of Recognizer-based architecture, BlinkID uses a streamlined session-based approach.
  • Modern TypeScript: Written with modern TypeScript features for improved developer experience.
  • Component-based UI: Simplified, customizable UI components for easier integration.
  • Simplified flow: More straightforward API with clearer separation of concerns.

Major API Changes​

  • New session-based API

    • Replaces the recognizer-based approach with a single, streamlined session model for easier scanning logic and better maintainability.

  • Modular SDK structure

  • Simplified initialization & result handling

    • New SDK initialization method:

      import { createBlinkId } from "@microblink/blinkid";

      const blinkid = await createBlinkId({
        licenseKey: "your-license-key",
      });

    • Results are now retrieved through structured session-based callbacks.

  • Enhanced UI customization

    • UI settings enable direct customization of typography, colors, and strings.
    • The modular architecture allows advanced modifications for branding and accessibility.

  • Renamed settings for improved clarity

    • blurStrictnessLevel → blurDetectionLevel
    • enableBlurFilter → skipFramesWithBlur
    • glareStrictnessLevel → glareDetectionLevel
    • enableGlareFilter → skipFramesWithGlare
    • combineFrameResults → enableMultiFrameExtraction
    • cardRotation→ documentRotation
    • And more...

Plan Your Upgrade​

Note that v6 is now considered legacy. Comprehensive documentation is in development - in the meantime, please refer to our example applications in the repository under apps/examples for integration patterns:

For any questions or feedback, reach out to support@microblink.com. We value your input and look forward to hearing how BlinkID v7 improves your app's experience!

Last updated on