Qualtrics Response Rate Badge

WHAT IT DOES

This userscript adds a real-time response rate dashboard to your Qualtrics survey pages. It reads response data from the page, extracts completed responses, partial responses, and total invited participants, then calculates the response rate percentage. A color-coded badge displays the response rate with a status indicator: green for high rates (above your configured threshold, default 50%), yellow for medium rates (25-50%), and red for low rates (below 25%). A progress bar visually shows the rate against 100%. The summary panel displays completed responses, partial responses (optional), and total invited counts. If enabled, the script tracks historical response rates for each survey, allowing you to compare the current survey's performance against previous surveys with a clear up/down indicator and percentage change. This helps researchers, market analysts, and survey administrators quickly assess survey health, identify low-performing surveys, and track response rate trends over time.

WHERE IT RUNS

The script runs on all Qualtrics web application pages at *.qualtrics.com/*, with automatic detection of survey distribution pages, results pages, and any page displaying survey response metrics. It works across all Qualtrics interfaces by using multiple selector strategies to find completed responses, partial responses, and total invited counts. The script detects dynamic content loading and re-applies the badge whenever the response data changes, including after filtering, refreshing, or pagination. It runs across the entire Qualtrics domain, ensuring coverage whether you're viewing a single survey, the survey dashboard, or distribution reports.

HOW TO USE

Install the script via the BotGentz extension and navigate to any Qualtrics survey distribution or results page. The response rate badge panel will appear automatically, showing your current response rate, status indicator, and progress bar. The summary panel displays completed responses, partial responses (toggleable), and total invited counts. Use the panel controls to customize your experience: toggle the response rate badge on or off, show or hide partial response tracking, enable or disable historical comparison, or adjust the high rate threshold. The historical comparison feature saves response rates for each survey and shows how the current survey compares to the previous one. The "Refresh data" button manually re-scans the page for updated response data, and the "Copy summary" button copies the metrics to your clipboard for reporting.

THE MECHANISM - DATA EXTRACTION, RATE CALCULATION, AND HISTORICAL TRACKING

This script identifies response data by scanning the page for Qualtrics' specific elements using a cascading selector strategy. It looks for completed responses through selectors like .completed-responses, .responses-completed, and data-test attributes. Partial responses are extracted similarly, and total invited is found through .total-invited, .invited-count, or by analyzing distribution statistics. Numbers are extracted using regular expressions that strip commas and non-numeric characters. The response rate is calculated as (completed / total_invited) × 100, with fallback logic using completed + partial if total is not found. For historical tracking, the script stores response rate data in GM_setValue using the survey name as a key, allowing comparison across surveys. The color-coded badge uses configurable thresholds to determine high, medium, and low status. The progress bar is rendered with CSS width based on the response rate percentage.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the Qualtrics page. Drag by the header to reposition it, and the position is saved per site using GM_setValue so it stays where you left it across sessions. Release the panel near any edge and it snaps into place, keeping your workspace organized. Click the panel header to collapse it into a small bubble showing only the chart emoji (📊), minimizing distraction while keeping controls accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes the response rate display, progress bar, summary metrics, settings controls, and action buttons. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Qualtrics, with the badge updating automatically as you move between surveys.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Qualtrics users who need to monitor survey response rates and track performance over time. The script reads only visible response data from the DOM—it does not access Qualtrics' API, your account credentials, or any sensitive information. All settings (badge visibility, partial response tracking, comparison toggle, high threshold, panel position, and historical data) are stored locally using GM_setValue and never leave your browser. The script does not modify your Qualtrics data—it only reads and displays visible information. Historical comparison data is stored per survey name; if survey names are not unique, the comparison may be less accurate. If Qualtrics updates its website structure, the script may need to be updated to match new selectors. The response rate is calculated based on data visible on the current page; if the response data is paginated, the script may not capture the full picture.