dynamsoft-docs · yqz562 · Jun 4, 2025 · Jun 20, 2025 · Jun 20, 2025 · Jun 20, 2025
diff --git a/.DS_Store b/.DS_Store
diff --git a/.gitignore b/.gitignore
@@ -5,3 +5,4 @@ logs/
 *.tmp
 temp/*
 !temp/keep.txt
+.DS_Store
diff --git a/_config.yml b/_config.yml
@@ -8,9 +8,11 @@ product-page-url: https://www.dynamsoft.com/faq
 product-name: /faq/
 product-title: Dynamsoft FAQ
 
-mobile-faq: /faq/dynamsoft-mobile/
-server-faq: /faq/dynamsoft-server/
-web-faq: /faq/dynamsoft-web/
+mobile-faq: /faq/dynamsoft-mobile
+server-faq: /faq/dynamsoft-server
+web-faq: /faq/dynamsoft-web
+general-faq: /faq/dynamsoft-general
+license-faq: /faq/dynamsoft-license
 
 useVersionTree: true
 

diff --git a/_data/full_tree.yml b/_data/full_tree.yml
@@ -1,4 +1,6 @@
 tree_file_list:
+  - sidelist-general.html
+  - sidelist-license.html
   - sidelist-server.html
   - sidelist-mobile.html
   - sidelist-web.html

diff --git a/_includes/sidelist-full-tree.html b/_includes/sidelist-full-tree.html
@@ -1,3 +1,5 @@
+{%- include liquid_searchVersionTreeFile.html ver=include.ver curPath=include.curPath targetRelativePath="sidelist-general.html" -%}
+{%- include liquid_searchVersionTreeFile.html ver=include.ver curPath=include.curPath targetRelativePath="sidelist-license.html" -%}
 {%- include liquid_searchVersionTreeFile.html ver=include.ver curPath=include.curPath targetRelativePath="sidelist-server.html" -%}
 {%- include liquid_searchVersionTreeFile.html ver=include.ver curPath=include.curPath targetRelativePath="sidelist-mobile.html" -%}
-{%- include liquid_searchVersionTreeFile.html ver=include.ver curPath=include.curPath targetRelativePath="sidelist-web.html" -%}
+{%- include liquid_searchVersionTreeFile.html ver=include.ver curPath=include.curPath targetRelativePath="sidelist-web.html" -%}
diff --git a/_includes/sidelist-general.html b/_includes/sidelist-general.html
@@ -0,0 +1,2 @@
+<li><a href="{{ site.general-faq }}/index.html" class="otherLinkColour">General </a>
+</li> 
diff --git a/_includes/sidelist-license.html b/_includes/sidelist-license.html
@@ -0,0 +1,2 @@
+<li><a href="{{ site.license-faq }}/index.html"  class="otherLinkColour">License </a>
+</li> 
diff --git a/_includes/sidelist-mobile.html b/_includes/sidelist-mobile.html
@@ -1,6 +1,23 @@
-<li><a href="{{ site.mobile-faq }}/android/index.html" class="otherLinkColour">Android</a>
+<!-- <li><a href="{{ site.mobile-faq }}/android/index.html" class="otherLinkColour">Android</a>
 </li>
 <li><a href="{{ site.mobile-faq }}/ios/index.html" class="otherLinkColour">iOS</a>
 </li>
 <li><a href="{{ site.mobile-faq }}/maui/index.html" class="otherLinkColour">Maui</a>
-</li>
+</li> -->
+<li>
+    <a style="cursor: pointer; color: #3c3c3c">Mobile</a>
+    <ul>
+        <li><a href="{{ site.mobile-faq }}/capabilities/index.html"  class="otherLinkColour">Capabilities</a>
+        </li>
+        <li><a href="{{ site.mobile-faq }}/scan-setting/index.html"  class="otherLinkColour">Scan Setting</a>
+        </li>
+        <li><a href="{{ site.mobile-faq }}/configuration/index.html"  class="otherLinkColour">Configuration</a>
+        </li>
+        <li><a href="{{ site.mobile-faq }}/debug/index.html"  class="otherLinkColour">Debug</a>
+        </li>
+        <li><a href="{{ site.mobile-faq }}/cross-platform/index.html"  class="otherLinkColour">Cross-Platform</a>
+        </li>
+        <li><a href="{{ site.mobile-faq }}/simulator/index.html"  class="otherLinkColour">Simulator</a>
+        </li>
+    </ul>
+</li>
diff --git a/_includes/sidelist-server.html b/_includes/sidelist-server.html
@@ -1,2 +1,7 @@
-<li><a href="{{ site.server-faq }}index.html" class="otherLinkColour">Server</a>
+<li>
+    <a style="cursor: pointer; color: #3c3c3c">Server</a>
+    <ul>
+        <li><a href="{{ site.server-faq }}/configuration/index.html" class="otherLinkColour">Configuration</a>
+        </li>
+    </ul>
 </li>
diff --git a/_includes/sidelist-web.html b/_includes/sidelist-web.html
@@ -1,2 +1,19 @@
-<li><a href="{{ site.web-faq }}index.html" class="otherLinkColour">Web</a>
+<!-- <li><a href="{{ site.web-faq }}index.html" class="otherLinkColour">Web</a>
+</li> --> 
+<li>
+    <a style="cursor: pointer; color: #3c3c3c">Web</a>
+    <ul>
+        <li><a href="{{ site.web-faq }}/camera/index.html" class="otherLinkColour">Camera</a>
+        </li>
+        <li><a href="{{ site.web-faq }}/capabilities/index.html" class="otherLinkColour">Capabilities</a>
+        </li> 
+        <li><a href="{{ site.web-faq }}/scan-setting/index.html" class="otherLinkColour">Scan Setting</a>
+        </li> 
+        <li><a href="{{ site.web-faq }}/configuration/index.html" class="otherLinkColour">Configuration</a>
+        </li> 
+        <li><a href="{{ site.web-faq }}/ui-customization/index.html" class="otherLinkColour">UI Customization</a>
+        </li> 
+        <li><a href="{{ site.web-faq }}/debug/index.html" class="otherLinkColour">Debug</a>
+        </li> 
+    </ul>
 </li>
diff --git a/dynamsoft-general/avoid-incorrect-results.md b/dynamsoft-general/avoid-incorrect-results.md
@@ -4,7 +4,7 @@ title: How to filter incorrect results with the barcode result length?
 keywords: Dynamsoft Barcode Reader, FAQ, DBR Introduction, General, incorrect results
 description: How to filter incorrect results with the barcode result length?
 needAutoGenerateSidebar: false
-permalink: /faq/general/avoid-incorrect-results.html
+/avoid-incorrect-results.html
 ---
 
 ## How to filter incorrect results with the barcode result length?

diff --git a/dynamsoft-general/dbr-supports-pdf.md b/dynamsoft-general/dbr-supports-pdf.md
@@ -4,7 +4,6 @@ title: Can Barcode Reader SDK read PDF files? Do I need to pay for this feature?
 keywords: Dynamsoft Barcode Reader, FAQ, DBR Introduction, General, PDF
 description: Can Barcode Reader SDK read PDF files? Do I need to pay for this feature?
 needAutoGenerateSidebar: false
-permalink: /faq/general/dbr-supports-pdf.html
 ---
 
 ## Can Barcode Reader SDK read PDF files? Do I need to pay for this feature?

diff --git a/dynamsoft-general/different-editions-of-dbr.md b/dynamsoft-general/different-editions-of-dbr.md
@@ -5,7 +5,6 @@ keywords: Dynamsoft Barcode Reader, FAQ, DBR Introduction, General, editions
 description: Which edition of Barcode Reader should I use?
 needAutoGenerateSidebar: false
 breadcrumbText: FAQ
-permalink: /faq/general/different-editions-of-dbr.html
 ---
 
 ## Which edition of Barcode Reader should I use?

diff --git a/dynamsoft-general/index.md b/dynamsoft-general/index.md
@@ -0,0 +1,19 @@
+---
+layout: default-layout
+title: General FAQ - Dynamsoft Barcode Reader FAQ
+keywords: faq, general, dbr, dynamsoft, barcode reader
+description: Dynamsoft Barcode Reader FAQ - General
+needAutoGenerateSidebar: false
+noTitleIndex: true
+---
+
+# General FAQ Index
+
+- [How to avoid incorrect barcode results?](avoid-incorrect-barcode-results.html)
+- [How to filter incorrect results with the barcode result length?](avoid-incorrect-results.html)
+- [Check Current Version](check-current-version.html)
+- [Does DBR support PDF?](dbr-supports-pdf.html)
+- [Different Editions of DBR](different-editions-of-dbr.html)
+- [How to scan specific pages of a pdf file?](scan-specific-page.html)
+- [How to scan US driver's license?](scan-us-drivers-license.html)
+- [Supported Barcode Formats](supported-barcode-formats.html)
diff --git a/dynamsoft-general/scan-specific-page.md b/dynamsoft-general/scan-specific-page.md
@@ -4,7 +4,6 @@ title: How to scan specific pages of a pdf file?
 keywords: Dynamsoft Barcode Reader, FAQ, DBR Introduction, scan specific page
 description: How to scan specific pages of a pdf file?
 needAutoGenerateSidebar: false
-permalink: /faq/general/scan-specific-page.html
 ---
 
 ## How to scan specific pages of a pdf file?
@@ -13,4 +12,4 @@ permalink: /faq/general/scan-specific-page.html
 
 We are planning to add `Pages` parameter of the `ImageParameterOptions` Parameter.
 
-Currently you will need to manually filter out the extra results from the returned retults or you can convert the specific pages pdf file to single image files and then decode the images. 
+Currently you will need to manually filter out the extra results from the returned retults or you can convert the specific pages pdf file to single image files and then decode the images.
diff --git a/dynamsoft-general/scan-us-drivers-license.md b/dynamsoft-general/scan-us-drivers-license.md
@@ -4,7 +4,6 @@ title: How to scan barcodes on US Driver's Licenses and extract the information?
 keywords: Dynamsoft Barcode Reader, FAQ, DBR Introduction, US driver's license
 description: How to scan barcodes on US Driver's Licenses and extract the information?
 needAutoGenerateSidebar: false
-permalink: /faq/general/scan-us-drivers-license.html
 ---
 
 ## How to scan barcodes on US Driver's Licenses and extract the information?

diff --git a/dynamsoft-general/supported-barcode-formats.md b/dynamsoft-general/supported-barcode-formats.md
@@ -4,7 +4,6 @@ title: What barcode types are supported by Dynamsoft Barcode Reader?
 keywords: Dynamsoft Barcode Reader, FAQ, DBR Introduction, General, formats
 description: What barcode types are supported by Dynamsoft Barcode Reader?
 needAutoGenerateSidebar: false
-permalink: /faq/general/supported-barcode-formats.html
 ---
 
 ## What barcode types are supported by Dynamsoft Barcode Reader?

diff --git a/dynamsoft-license/dbr-free-trial.md b/dynamsoft-license/dbr-free-trial.md
@@ -4,7 +4,6 @@ title: What I need to know about trial licenses?
 keywords: Dynamsoft Barcode Reader, FAQ, DBR Introduction, General, free trial
 description: What I need to know about trial licenses?
 needAutoGenerateSidebar: false
-permalink: /faq/general/dbr-free-trial.html
 ---
 
 ## What I need to know about trial licenses?
@@ -13,4 +12,4 @@ permalink: /faq/general/dbr-free-trial.html
 
 To get a free trial of the SDK, please download it from [our website](https://www.dynamsoft.com/barcode-reader/downloads/).
 
-The main way to get the trial license is via the [Request a Trial License](https://www.dynamsoft.com/customer/license/trialLicense?product=dbr&utm_source=docs){:target="_blank"} link through which you can extend your trial license once your original expires. The trial can be extended twice, for 15 days each, and a total of 30 days.
+The main way to get the trial license is via the [Request a Trial License](https://www.dynamsoft.com/customer/license/trialLicense?product=dbr&utm_source=docs){:target="\_blank"} link through which you can extend your trial license once your original expires. The trial can be extended twice, for 15 days each, and a total of 30 days.
diff --git a/dynamsoft-license/dbr-supports-pdf.md b/dynamsoft-license/dbr-supports-pdf.md
@@ -4,7 +4,6 @@ title: Can Barcode Reader SDK read PDF files? Do I need to pay for this feature?
 keywords: Dynamsoft Barcode Reader, FAQ, DBR Introduction, General, PDF
 description: Can Barcode Reader SDK read PDF files? Do I need to pay for this feature?
 needAutoGenerateSidebar: false
-permalink: /faq/general/dbr-supports-pdf.html
 ---
 
 ## Can Barcode Reader SDK read PDF files? Do I need to pay for this feature?
@@ -13,4 +12,4 @@ permalink: /faq/general/dbr-supports-pdf.html
 
 Dynamsoft Barcode Reader does indeed support reading barcodes from PDF files (see [Features](https://www.dynamsoft.com/barcode-reader/features/#Decode-Barcodes)). The only exception is the JavaScript and Mobile editions currently.
 
-No extra license is required to read from PDF files.
+No extra license is required to read from PDF files.
diff --git a/dynamsoft-license/expand-quota-for-runtime-license.md b/dynamsoft-license/expand-quota-for-runtime-license.md
@@ -4,7 +4,6 @@ title: How to expand the quota of a runtime license?
 keywords: Dynamsoft Barcode Reader, FAQ, Pricing/Licensing, General, expand quota
 description: How to expand the quota of a runtime license?
 needAutoGenerateSidebar: false
-permalink: /faq/general/expand-quota-for-runtime-license.html
 ---
 
 ## How to expand the quota of a runtime license?

diff --git a/dynamsoft-license/how-hardware-is-bind-to-license.md b/dynamsoft-license/how-hardware-is-bind-to-license.md
@@ -4,7 +4,6 @@ title: What I need to know about licensing process?
 keywords: Dynamsoft Barcode Reader, FAQ, Pricing/Licensing, General, information gathered, hardware bind, new license consumption
 description: What I need to know about licensing process?
 needAutoGenerateSidebar: false
-permalink: /faq/general/how-hardware-is-bind-to-license.html
 ---
 
 ## What I need to know about licensing process?

diff --git a/dynamsoft-license/index.md b/dynamsoft-license/index.md
@@ -0,0 +1,21 @@
+---
+layout: default-layout
+title: License FAQ - Dynamsoft Barcode Reader FAQ
+keywords: faq, license, dbr, dynamsoft, barcode reader, configuration
+description: Dynamsoft Barcode Reader FAQ - License
+needAutoGenerateSidebar: false
+noTitleIndex: true
+---
+
+# License FAQ Index
+
+- [Does DBR support PDF?](dbr-supports-pdf.html)
+- [How to ensure no overuse of license?](ensure-no-overuse.html)
+- [How to expand the quota for a runtime license?](expand-quota-for-runtime-license.html)
+- [How is hardware bound to a license?](how-hardware-is-bind-to-license.html)
+- [How does license tracking work?](how-license-tracking-works.html)
+- [How to use offline registration license type?](offline-registration-license.html)
+- [SDK works without internet?](sdk-works-without-internet.html)
+- [How to track license usage?](track-license.html)
+- [New license required for per-device licensing?](new-license-required-per-device-licensing.html)
+- [How to get a free trial?](dbr-free-trial.html)
diff --git a/dynamsoft-license/offline-registration-license.md b/dynamsoft-license/offline-registration-license.md
@@ -4,25 +4,22 @@ title: How to use offline registration license type?
 keywords: Dynamsoft Barcode Reader, FAQ, offline, license type
 description: How to use offline registration license type?
 needAutoGenerateSidebar: false
-permalink: /faq/general/offline-registration-license.html
 ---
 
 ## How to use offline registration license type?
 
 [<< Back to FAQ index](index.md)
 
-
 You can follow the steps below to manually register the device and get the license key for each device:
 
 1. Log in [Customer Portal](https://www.dynamsoft.com/customer/license/fullLicense) -> Click the Activate button to activate the license
-![activate](./assets/activate.jpg)
-
+   ![activate](./assets/activate.jpg)
 
 2. Select the 3rd option "No License Server. Register Offline Device(s) Manually" and click Activate.
-![offline-activate](./assets/offline-activate.jpg)
+   ![offline-activate](./assets/offline-activate.jpg)
 
 3. Click the Add Device button then it will pop up a dialog. Download the tool from the pop up.
-![uuid-tool](./assets/uuid-tool.jpg)
+   ![uuid-tool](./assets/uuid-tool.jpg)
 
 4. Unzip the file and run the GenerateUUID tool on the device to be registered and get the UUID.<br>
 
@@ -33,7 +30,6 @@ For Windows:<br>
 The returned string, e.g. 8ECCA3B6-66F9-4fd6-B6B6-308C874140C6, is the machine ID.<br>
 ![uuid](./assets/uuid.jpg)<br>
 
-
 For Linux:<br>
 -Open Terminal<br>
 -Change the working directory to the one where GenerateUUID.exe is<br>
@@ -44,65 +40,78 @@ You will see the generated UUID like this (the ID should be different)<br>
 SoftbindUUID:230e089a-7dc3-4caa-9c77-f7cc6d567f9b<br>
 "230e089a-7dc3-4caa-9c77-f7cc6d567f9b" is the generated UUID. You can now use it to register the device and get an Authorization String for it.<br>
 
-> Note: If your device is an arm based architecture, please use get device uuid API to generate the uuid: 
+> Note: If your device is an arm based architecture, please use get device uuid API to generate the uuid:
+>
 > ```python
 > # sample code in python
 > print(BarcodeReader.get_device_uuid(1))
 > ```
 
 > Note: If you want multiple users in operating system to use the license, you will need to move the .Dynamsoft folder to a path where all the users can access. Let us say `/Home/shared/.Dynamsoft`.
 > For all the programs in the devices, you will need to set the license cache path to `/Home/shared` before initialize the license
+>
 > ```python
 > # set license cache path before initialize the license
 > BarcodeReader.set_license_cache_path("/Home/shared")
 > ```
 
-
 5. Input the generated UUID and device name and click Submit.
-![submit-uuid](./assets/submit-uuid.jpg)
+   ![submit-uuid](./assets/submit-uuid.jpg)
 
 6. Then an authorization string will be generated. This string is the license for this device. Copy the license and set it in the code
-![cp-license](./assets/cp-license.jpg)
+   ![cp-license](./assets/cp-license.jpg)
 
 Code snippet in JavaScript:
+
 ```javascript
 Dynamsoft.DBR.BarcodeScanner.license = "DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…";
 let scanner = await Dynamsoft.DBR.BarcodeScanner.createInstance();
 ```
 
 Code snippet in C:
+
 ```C
   char errorBuf[512];
   DBR_InitLicense("DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…", errorBuf, 512);
   void* barcodeReader = DBR_CreateInstance();
   // add further process
 ```
+
 Code snippet in C++
+
 ```C++
   char errorBuf[512];
   dynamsoft::dbr::CBarcodeReader::InitLicense("DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL …", errorBuf, 512);
   CBarcodeReader* reader = new CBarcodeReader();
   // add further process
 ```
+
 Code snippet in C#:
+
 ```C#
 string errorMsg;
   BarcodeReader.InitLicense("DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…", out errorMsg);
   BarcodeReader reader = new BarcodeReader();
   // add further process
 ```
+
 Code snippet in Java:
+
 ```Java
   BarcodeReader.initLicense("DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…");
   BarcodeReader reader = new BarcodeReader();
   // add further process
 ```
+
 Code snippet in Python:
+
 ```Python
 error = BarcodeReader.init_license("DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…")
 dbr = BarcodeReader()
 ```
+
 Code snippet in Android SDK:
+
 ```java
 BarcodeReader.initLicense("DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…", new DBRLicenseVerificationListener() {
   @Override
@@ -111,22 +120,23 @@ BarcodeReader.initLicense("DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…", new DBRLicens
   }
 });
 ```
+
 Code snippet in Objective-C:
+
 ```Objective-C
 [DynamsoftBarcodeReader initLicense:@" DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…" verificationDelegate:self];
 - (void)DBRLicenseVerificationCallback:(bool)isSuccess error:(NSError *)error
 {
   // Add your code for license verification.
 }
 ```
+
 Code snippet in Swift:
+
 ```Swift
 DynamsoftBarcodeReader.initLicense("DLC2+4LgkxoZik5yCuJxMDneqJPVQZJROL…", verificationDelegate: self)
 func dbrLicenseVerificationCallback(_ isSuccess: Bool, error: Error?)
 {
   // Add your code for license verification.
 }
 ```
-
-
-
diff --git a/dynamsoft-license/sdk-works-without-internet.md b/dynamsoft-license/sdk-works-without-internet.md
@@ -4,7 +4,6 @@ title: Can the SDK work without internet connection?
 keywords: Dynamsoft Barcode Reader, FAQ, Pricing/Licensing, General, internet
 description: Can the SDK work without internet connection?
 needAutoGenerateSidebar: false
-permalink: /faq/general/sdk-works-without-internet.html
 ---
 
 ## Can the SDK work without internet connection?
-Original file line number
+Diff line change
@@ Expand Up / @@ -5,3 +5,4 @@ logs/ @@
     *.tmp
     temp/*
     !temp/keep.txt
+    .DS_Store
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		<li><a href="{{ site.general-faq }}/index.html" class="otherLinkColour">General </a>
		</li>
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		<li><a href="{{ site.license-faq }}/index.html" class="otherLinkColour">License </a>
		</li>