Dev Center
Table of contents

Thanks for Downloading Dynamic Web TWAIN 30-Day Trial!

Your download will start shortly. If your download does not begin, click here to retry.


This upgrade section talks about how to upgrade Dynamic Web TWAIN to a newer version.

How to upgrade

You can follow the steps below to upgrade Dynamic Web TWAIN:

  1. Back up your current copy of dynamsoft.webtwain.config.js.

  2. On your development machine, uninstall the old version of Dynamic Web TWAIN and install the new one.

  3. Get the new Resources folder under the installation folder of Dynamic Web TWAIN and update the folder in your application. Use your original dynamsoft.webtwain.config.js if you want to keep the old settings.

    Typical paths of Dynamic Web TWAIN folder:

    • Windows: C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN SDK {Version Number}\
    • macOS: Applications > Dynamsoft > Dynamic Web TWAIN SDK {Version Number}
  4. Make necessary updates to the related code.

    If you get a new license key for the new version, you may follow the steps in License to update it.

    For changes in the new version, you can check the Release Notes and Deprecations.

    Note: Please be aware of the following namespace changes introduced in v17.0:

    v17.0+ v16.2-
    Dynamsoft.DWT Dynamsoft.WebTwainEnv
    Dynamsoft.DWT.EnumDWT_ Dynamsoft.EnumDWT_
    Dynamsoft.DBR.EnumBarcodeFormat Dynamsoft.EnumBarcodeFormat
  5. Deploy the new version files to your server and test.

Beginning with Dynamic Web TWAIN v16.0, the Dynamsoft Service is backward compatible within the same major version. Once you upgrade Dynamic Web TWAIN for your application on the server side, for end-users’ side

  • If the end-users have installed the same version or newer minor versions of Dynamsoft Service, they don’t need to do anything;
  • If the end-users have never installed Dynamsoft Service, or have an older version or a different newer major version of it, they will be required to do a reinstallation of Dynamsoft Service. The process is described here

Update dwt package

If your application uses a framework or library like Angular, React, Vue, etc. and uses the dwt package, you can just install the new version of Dynamic Web TWAIN to replace the old one and update the types definition as well. For example:

For npm:

npm install dwt
npm install @types/dwt

For Yarn:

yarn add dwt
yarn add @types/dwt

Is this page helpful?

YesYes NoNo

In this article:

latest version

    • Latest Version (18.5)
    • Version 18.4
    • Version 18.3
    • Version 18.1
    • Version 18.0
    • Version 17.3
    • Version 17.2.1
    • Version 17.1.1
    • Version 17.0
    • Version 16.2
    • Version 16.1.1
    Change +