iCIMS Application Status Tracker

WHAT IT DOES

This userscript transforms your iCIMS ATS candidate list into a dynamic status tracking dashboard. It reads the application status from each candidate row and displays a compact, color-coded badge directly on the candidate's name. Each status (New, In Review, Interview, Offer, Hired, Rejected, and any custom statuses) is assigned a distinct color that makes pipeline distribution instantly visible. Beyond simple status display, the script tracks when each candidate entered their current status and shows a small days-in-status indicator (e.g., "(5d)") on each badge. When a candidate's status changes, the script can send a desktop notification alerting you to the change. The tracking is persistent across sessions, so you can see how long candidates have been waiting in each stage of your pipeline. This helps identify bottlenecks, prioritize follow-ups, and ensure no candidate gets stuck in a status for too long.

WHERE IT RUNS

The script runs on all iCIMS ATS pages at *.icims.com/*, including the main candidate search view, requisition-specific candidate lists, pipeline views, and any page displaying candidate rows in table format. It automatically detects candidate rows using multiple selector strategies that work with various iCIMS interface versions. The script responds to dynamic content loading, filtering, sorting, and pagination, reapplying status badges whenever the candidate list updates. It runs across the entire iCIMS domain, ensuring coverage whether you're reviewing candidates for a specific job or viewing your entire talent pipeline.

HOW TO USE

Install the script via the BotGentz extension and navigate to any candidate list in iCIMS. Status badges will appear automatically on every candidate row. Use the panel controls to customize your experience: toggle days-in-status indicators on or off, enable or disable row background highlighting for additional visual cues, or control whether status change notifications appear. The panel includes a complete color management system where you can customize the color for any existing status or add new statuses with custom colors. Simply click the color picker next to any status name to change its color, or use the "Add Custom Status" section to add colors for statuses your organization uses that aren't in the default set. The "Refresh statuses" button manually reapplies all badges, while "Clear status history" resets the tracked status change data.

THE MECHANISM - STATUS DETECTION, PERSISTENT TRACKING, AND CHANGE DETECTION

This script uses a multi-layered approach to detect application statuses. It first scans each candidate row for known iCIMS status elements using selectors like .status, .application-status, [data-test="status"], and .candidate-status. When those fail, it analyzes all text content in the row for status keywords including "New," "In Review," "Interview," "Offer," "Hired," "Rejected," "Withdrawn," and "Pending." The most confident match is selected as the candidate's current status. For tracking, the script generates a unique identifier for each candidate based on their name or data attributes, then stores the detected status and timestamp in GM_setValue. On subsequent page loads, the script compares the current status against the stored status. If a change is detected, it triggers a desktop notification and updates the stored timestamp. The days-in-status indicator calculates the difference between the current timestamp and the stored timestamp for that status, showing exactly how many days the candidate has been in their current stage. This provides actionable insight into candidate aging within your pipeline.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the iCIMS 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 all settings toggles, color management 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 iCIMS, with status badges updating automatically as you move between views.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for iCIMS ATS users who manage candidate pipelines and need visibility into status distribution and aging. The script reads only visible candidate data from the DOM - it does not access iCIMS's API, your account credentials, or any sensitive information. All settings and status history are stored locally using GM_setValue and never leave your browser. The script does not modify your iCIMS data - it only enhances the visual presentation of the candidate list and provides local tracking. If iCIMS updates its website structure, the script may need to be updated to match new selectors; check for updates if the badges stop appearing. The status history is stored per candidate identifier and may accumulate over time; use the "Clear status history" button to reset tracking data if needed.