Gusto Bulk Employee Document Uploader

WHAT IT DOES

Gusto Bulk Employee Document Uploader lets you upload a document to multiple employees in a single operation. Instead of opening each employee record individually, navigating to the documents section, selecting a file, uploading, and saving — repeating this for every single employee — this tool provides a unified checklist of all employees on the current page. You can filter employees by name to quickly find the ones you want to upload documents for. Select any number of employees using checkboxes, choose a file from your computer using the file picker, and click Upload. The tool then automatically processes each selected employee — opening the document upload modal, selecting the file, and saving the upload. This turns what could be dozens of manual operations into a single batch action, making employee document management and HR record keeping significantly faster and more efficient.

WHERE IT RUNS

This script runs exclusively on the Gusto web application in your browser. It activates on the employee list page within the Gusto dashboard. It requires the BotGentz extension to inject and execute the script. The tool does not work on the Gusto mobile app, the API, or any third-party Gusto clients — only the web-based Gusto interface accessed through a Chromium-based or Firefox browser. It specifically targets pages under *.gusto.com, including the Gusto employee list and team views.

HOW TO USE

After installing the script via BotGentz, navigate to your Gusto dashboard and open the Employees or Team page. The tool automatically detects the employee list and displays a floating panel on the right side. The panel shows all employees on the current page, with checkboxes next to each employee entry. Each employee displays their name, department, and status with a color indicator. Use the search box to filter by name to narrow down your selection. Check the boxes for every employee you want to upload a document to. Below the employee list, click the file picker button to select a document from your computer — supported file types include PDF, DOC, DOCX, JPG, JPEG, PNG, and TXT. The selected file name and size are displayed for confirmation. Click "Upload to Selected" and confirm the action. The tool will process each selected employee one by one — opening the document upload modal, selecting the file, and saving. A status message appears when the operation completes, showing how many employees were successfully uploaded to.

THE ACTUAL MECHANISM — WHY IT WORKS

Gusto's web interface is built with React and uses a component-based rendering system for its employee management. The employee list is rendered as table rows or cards, each containing employee metadata and action buttons. This tool scans the DOM for employee items using multiple selector patterns that Gusto consistently uses across versions. For each employee, it extracts the name, department, and status from the visible text content and data attributes. Each employee is assigned a unique identifier from data attributes or checkbox values. When uploading documents, the tool locates the document upload button within each employee item and triggers a click event that opens Gusto's document upload modal. The modal contains a file input field. The tool uses a DataTransfer object to programmatically set the selected file onto the file input, then dispatches a change event to trigger React's file selection handlers. The tool then clicks the modal's upload/confirm button, waits for the upload to complete, and proceeds to the next employee. This approach works without making direct API calls, which would require authentication credentials and knowledge of Gusto's internal API structure. By using the existing UI, the tool works within Gusto's own permission and validation system, and continues to function even if the underlying API changes.

THE PANEL

The floating panel is fully draggable — click and drag the header to reposition it anywhere on the page. The panel's position is saved per site in localStorage, so it reappears exactly where you left it when you return to the employee list. Double-click the header to snap the panel to the nearest edge (left or right). A collapse button minimizes the panel to a small tab showing a document emoji badge, keeping it out of the way while still accessible. The employee list inside the panel is scrollable and resizes vertically based on the number of employees. Pressing Escape while the panel is focused closes it completely; reopening is done via a small button injected near the page toolbar. All panel interactions are non-blocking — Gusto's main UI remains fully responsive while the panel is open, and the panel updates automatically when you navigate between pages.

PLEASE NOTE

This script requires the BotGentz extension (free) to run user scripts on Gusto. Gusto frequently updates its web interface and modal structures; if the tool stops working, check for an updated version within BotGentz's script repository. This tool does not store, transmit, or log any employee data, document content, or file information — all operations occur locally in your browser with no external network requests except those made by Gusto itself. Document uploads are applied through Gusto's own UI event system, so all changes respect your user permissions and HR data policies. The tool does not bypass Gusto's security or permission system; it simply automates the clicks you would otherwise perform manually. For organizations with a large number of employees, the tool may take several minutes to complete the operation, as each employee is processed sequentially with delays to avoid overwhelming the UI. A progress indicator shows which employee is currently being processed. Always double-check your selections and the selected file before applying changes, as bulk document uploads can affect multiple employee records. The tool only affects employees visible on the current page; to upload to all employees, use Gusto's built-in pagination controls or adjust your filters to show all relevant employees. Supported file types are limited to those accepted by Gusto's document upload system.