From 57e8c761f1973087aff559ab6166b1eb53131843 Mon Sep 17 00:00:00 2001
From: Paul Huliganga <paje0101@gmail.com>
Date: Wed, 22 Apr 2026 22:33:44 -0400
Subject: [PATCH] Clarify verification recipient behavior

---
 web/static/js/settings.js     | 6 +++---
 web/static/js/verification.js | 4 ++++
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/web/static/js/settings.js b/web/static/js/settings.js
index bafd6a4..a228e87 100644
--- a/web/static/js/settings.js
+++ b/web/static/js/settings.js
@@ -33,13 +33,13 @@ export function renderSettings() {
     <div class="settings-section">
       <div class="settings-section-header">
         <div class="settings-section-title">Verification</div>
-        <div class="settings-section-sub">Default recipient for test envelopes</div>
+        <div class="settings-section-sub">Default recipient for test envelopes. The same name and email are used for every recipient role on the template during a test send.</div>
       </div>
       <div class="settings-section-body">
         <div class="setting-row">
           <div class="setting-body">
             <div class="setting-label">Test Recipient Name</div>
-            <div class="setting-desc">Pre-filled in the Send Test dialog on the Verification screen</div>
+            <div class="setting-desc">Pre-filled in the Send Test dialog on the Verification screen and reused for all recipient roles in the template.</div>
           </div>
           <div class="setting-control" style="min-width:240px">
             <input type="text" class="form-input" id="set-recipient-name"
@@ -50,7 +50,7 @@ export function renderSettings() {
         <div class="setting-row">
           <div class="setting-body">
             <div class="setting-label">Test Recipient Email</div>
-            <div class="setting-desc">Pre-filled in the Send Test dialog</div>
+            <div class="setting-desc">Pre-filled in the Send Test dialog and used on every recipient role when sending a verification envelope.</div>
           </div>
           <div class="setting-control" style="min-width:240px">
             <input type="email" class="form-input" id="set-recipient-email"
diff --git a/web/static/js/verification.js b/web/static/js/verification.js
index 8f4f02c..64b8259 100644
--- a/web/static/js/verification.js
+++ b/web/static/js/verification.js
@@ -154,6 +154,10 @@ function _showSendDialog(t, settings) {
         <div style="font-size:13px;color:var(--text-muted);margin-bottom:14px">
           Template: <strong>${escHtml(t.name)}</strong>
         </div>
+        <div class="callout info" style="margin-bottom:14px">
+          <span class="callout-icon">ℹ️</span>
+          This test send uses the same recipient name and email for every recipient role in the template. That is expected for a basic verification run.
+        </div>
         <div class="form-group">
           <label class="form-label" for="sd-name">Recipient Name</label>
           <input type="text" class="form-input" id="sd-name"