BambooHR Org Chart Search Enhancer

WHAT IT DOES

BambooHR Org Chart Search Enhancer adds powerful search capabilities to your BambooHR org chart. It enhances the existing search with advanced filters for department, location, job title, and team—letting you quickly narrow down employees. The smart search matches employees by name, title, department, or location, and a persistent search history lets you re-run previous searches with one click. Matching employees are highlighted in the org chart, and nodes containing search results auto-expand so you never miss a match. A panel overlay shows the current filter settings, search history, and a live employee count summary. This makes navigating large org charts significantly faster and helps you find the people you need in seconds.

WHERE IT RUNS

This script runs on BambooHR org chart pages (*.bamboohr.com/*). It operates entirely within your browser tab, reading the page's DOM to locate employee nodes, search input, and org chart structure. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including filter enablement, history saving, highlight preference, auto-expand preference, employee count visibility, and auto-detect preference—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically detects BambooHR org chart pages and enhances the search interface (if auto-detect is enabled). Use the search bar to type a name, title, department, or location—matches are highlighted and counted instantly. The panel shows a search history—click any past search to re-run it. The employee count summary shows how many employees match your search and how many total employees are in the org chart. Toggle highlighting on or off, enable auto-expand to automatically expand nodes containing matches, and clear your search history at any time. Use the panel settings to customize your experience.

THE REAL MECHANISM

The script detects BambooHR org chart pages by checking if the URL contains '/orgchart', '/org-chart', or '/org'. It locates the search input using selectors like input[type="search"], input[placeholder*="Search"], and .org-chart-search input. Employee nodes are detected using selectors like .employee-node, .org-node, .org-chart-node, .employee-card, and .person-node. For each node, the script extracts employee data—name from .employee-name or .name, job title from .job-title or .title, department from .department or .team, and location from .location or .office. The search function matches employees by comparing the search query against all extracted fields, with support for multiple search terms. The filter system applies additional restrictions based on department, location, and title selections. Highlighting applies a background color and border to matching employee nodes. Auto-expand finds parent containers of matching nodes and clicks any expand buttons if they exist. Search history is stored in GM_setValue as a JSON array with timestamps, with a maximum of 20 entries. All DOM manipulation uses safe methods with no innerHTML from untrusted content.

THE PANEL

The Org Search panel is a BGPanel component that 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 search history and settings. 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. BambooHR frequently updates its UI, which may change class names, data-testid attributes, and DOM structure—the script may require updates to maintain compatibility. The employee node detection relies on the org chart being fully loaded; if the page is still loading, the script may not detect all nodes. The auto-expand feature attempts to click expand buttons, which may not work if the org chart uses a different expand mechanism. The search history is stored locally and is not synced across devices. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your filter enablement, history enablement, highlight preference, auto-expand preference, employee count visibility, and auto-detect preference locally. No employee data, org chart information, or personal information is ever collected, transmitted, or shared.