Gainsight Web Health Score Trend Badge

WHAT IT DOES

This userscript helps customer success managers monitor account health by displaying health score trends and alerts directly on Gainsight dashboards. It scans Gainsight customer success dashboard pages for health scores, trend indicators, and recent changes in customer health. It then displays a visual badge or panel showing the current health score, trend direction (improving, declining, stable), and the magnitude of change over time. The script highlights accounts with declining health scores, shows the health score history, compares scores across different time periods, and displays a mini trend chart for each account. It categorizes health scores with status colors (Red, Yellow, Green) and provides alerts for accounts that need attention (e.g., "Health score dropped 10 points in 30 days").

WHERE IT RUNS

The script runs on Gainsight customer success dashboard pages. It works entirely within your browser, reading only the visible content of the current page. It does not track your browsing history, access other tabs, or send any data externally. All health score data is processed locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. The script auto-scans Gainsight dashboard pages on load (toggle this on/off). Choose your display mode—"Badge only" shows a floating badge in the corner, "Panel only" shows details in the panel, or "Both" shows both. Toggle "Show trend chart" to display mini charts for each account. Click "Scan health scores" to manually analyze the page. The badge displays the average health score, number of declining accounts, and the worst declining account. The panel shows a full breakdown: each account's name, health score with color coding, trend direction, trend magnitude, status (Red/Yellow/Green), last updated date, and a mini trend chart. Use "Clear data" to remove all overlays.

THE TECHNICAL MECHANISM

This script uses DOM traversal and pattern matching to extract health score data from Gainsight dashboard pages. It scans for health score elements using selectors like .health-score, .account-health, .customer-health, .score, [class*="health"], and [class*="score"]. For each element, it extracts the account name from title elements, health score using "health score: X" patterns, previous score using "previous: X" patterns, trend using "X points change" patterns, and status/color from text content (Red, Yellow, Green). It also extracts last updated dates. The script calculates trend direction and magnitude, generates mini trend charts using canvas for each account (simulated trend data based on current score and trend), and provides alerts for accounts with significant declines. All settings are persisted locally.

THE PANEL

The panel is draggable anywhere on the screen and remembers its position between sessions. It can be collapsed to a small floating bubble to minimize distraction, and expanded again with a single click. The panel's width can be adjusted, and pressing the Escape key closes it instantly. All settings—display mode, show trend, and auto-scan—are persisted locally using GM_setValue, so your preferences remain intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script is designed for Gainsight customer success dashboards; it may work on other customer health platforms but is not guaranteed. The extraction relies on the current HTML structure of Gainsight—if Gainsight updates its UI, the script may need to be updated. The mini trend charts are simulated based on the current health score and trend, not actual historical data. Alerts are based on trend thresholds and are suggestions, not definitive analysis. The script does not access your Gainsight account or API; it only reads what is visible on the page. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.