DocuSign Envelope Status Badge

WHAT IT DOES

DocuSign Envelope Status Badge scans your DocuSign envelope pages and displays a floating badge with the current envelope status. The status is color-coded: green for Completed, blue for Sent/Delivered/In Progress, yellow for Draft, red for Declined/Voided/Expired, and gray for other statuses. The badge also shows additional details including envelope subject, sender name, recipient count, sent date, and days since sent. The badge updates automatically at a configurable refresh interval, so you always see the latest status. You can copy the entire status summary as text for reporting or follow-up. This gives you instant visibility into your envelope status without searching through the page.

WHERE IT RUNS

This script runs on DocuSign envelope pages (*.docusign.com/*). It operates entirely within your browser tab, reading the page's DOM to locate the envelope header, status indicators, and metadata. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including badge position, subject visibility, sender visibility, recipient visibility, sent date visibility, auto-detect preference, and refresh interval—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically detects DocuSign envelope pages and displays the status badge (if auto-detect is enabled). The badge shows the envelope status with a color-coded dot, subject, sender, recipients, and sent date. Click "Load Envelope Status" to manually refresh the data. The badge updates automatically at the configured refresh interval. Customize the badge position (top-left, top-right, bottom-left, bottom-right, or float), toggle subject, sender, recipients, and sent date visibility on or off, and set the refresh interval (5-300 seconds). Click "Copy Status Summary" to copy a formatted summary to your clipboard.

THE REAL MECHANISM

The script detects DocuSign envelope data using selectors like .envelope-subject, .subject, [data-testid="envelope-subject"] for the subject; .envelope-status, .status-badge, .status-label for the status; .sender, .sender-name for the sender; .recipients, .recipient-count for recipient count; and .sent-date, .date-sent, [data-testid="sent-date"] for the sent date. The status color is determined by a mapping function that checks for keywords like "completed," "sent," "delivered," "in progress," "draft," "declined," "voided," and "expired." Days since sent is calculated by parsing the sent date and comparing it to the current date. The badge is rendered with the status color as a dot indicator and the status text. The refresh interval uses setInterval to re-fetch data automatically. All DOM manipulation uses safe methods with no innerHTML from untrusted content.

THE PANEL

The Envelope Status badge is displayed within the BGPanel component, which you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the status details. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. DocuSign frequently updates its UI, which may change class names, data-testid attributes, and DOM structure—the script may require updates to maintain compatibility. The status extraction relies on the presence of status indicators on the page; if the page is using a custom view, the script may not detect the status. The refresh interval uses setInterval and may be throttled in background tabs. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your badge position, subject visibility, sender visibility, recipient visibility, sent date visibility, auto-detect preference, and refresh interval locally. No envelope data, document information, or personal information is ever collected, transmitted, or shared.