From 6e5eb35cd1e4a5a982fa3275376b3005ccff52c2 Mon Sep 17 00:00:00 2001
From: Andrii Shvaika <ashvayka@thingsboard.io>
Date: Mon, 6 Apr 2026 17:48:53 +0300
Subject: [PATCH] fix(iot-hub): resolve helpImage paths from ZIP images

The helpImage field in form definitions was rendered with the raw path
from the ZIP. Now resolved through zipImages map to get the base64 data
URI, same as markdown images.
---
 .../device-install-dialog.component.html                   | 2 +-
 .../device-install-dialog.component.ts                     | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/ui-ngx/src/app/modules/home/components/iot-hub/device-install-dialog/device-install-dialog.component.html b/ui-ngx/src/app/modules/home/components/iot-hub/device-install-dialog/device-install-dialog.component.html
index 9958a877ba..b8dbe2bd92 100644
--- a/ui-ngx/src/app/modules/home/components/iot-hub/device-install-dialog/device-install-dialog.component.html
+++ b/ui-ngx/src/app/modules/home/components/iot-hub/device-install-dialog/device-install-dialog.component.html
@@ -154,7 +154,7 @@
                             <div class="tb-form-field-help">{{ field.helpText }}</div>
                           }
                           @if (field.helpImage) {
-                            <img class="tb-form-field-help-image" [src]="field.helpImage" [alt]="field.label">
+                            <img class="tb-form-field-help-image" [src]="resolveImagePath(field.helpImage)" [alt]="field.label">
                           }
                         }
                       </form>
diff --git a/ui-ngx/src/app/modules/home/components/iot-hub/device-install-dialog/device-install-dialog.component.ts b/ui-ngx/src/app/modules/home/components/iot-hub/device-install-dialog/device-install-dialog.component.ts
index 21c8254593..4348b7a3bb 100644
--- a/ui-ngx/src/app/modules/home/components/iot-hub/device-install-dialog/device-install-dialog.component.ts
+++ b/ui-ngx/src/app/modules/home/components/iot-hub/device-install-dialog/device-install-dialog.component.ts
@@ -275,6 +275,13 @@ export class TbDeviceInstallDialogComponent extends DialogComponent<TbDeviceInst
     });
   }
 
+  resolveImagePath(path: string): string {
+    if (path.startsWith('data:') || path.startsWith('http')) {
+      return path;
+    }
+    return this.zipImages.get(path) || path;
+  }
+
   getPatternErrorMessage(field: FormFieldDefinition): string {
     return field.validators?.[0]?.message || 'Invalid format';
   }