Gmail Bulk Label Applier Across Threads

WHAT IT DOES

This userscript helps you organize your Gmail inbox by applying labels to multiple email threads at once. It scans Gmail inbox or email list pages for email threads, displays a list of threads with checkboxes, and allows you to select multiple threads to bulk apply a label (e.g., "Important", "To-Do", "Follow-up", or custom labels). It shows the subject and sender of each thread, filters by existing labels, and maintains a list of already labeled threads to avoid duplicates. It exports the list of selected threads and provides a confirmation step before taking action. The script simulates the label application by marking threads with the selected label.

WHERE IT RUNS

The script works on Gmail inbox pages, email list pages, and any webpage with email thread information. It runs 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 thread data and label history are stored locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Click "Scan for threads" to extract email threads from the current page. The panel displays a list of threads with checkboxes, showing the subject, sender, and existing labels. Enter the label name you want to apply in the "Label name" field. Select the threads you want to label—use "Select All" to choose all. Click "Apply Label to Selected" to mark them as labeled and add them to your history. Click "Export Selected" to download a text file with the selected thread information. Use "Clear History" to reset the label history.

THE TECHNICAL MECHANISM

This script uses DOM traversal and text pattern matching to extract email thread information from Gmail pages. It scans for thread elements using class names like "thread", "email", "zA", "zE", and "yW". For each thread, it extracts the subject (looking for "Subject:" patterns), sender (looking for "From:" patterns and email addresses), and existing labels (extracting capitalized words from the text). It deduplicates threads by subject and sender. The script stores the label history in GM_setValue so you don't see already-labeled threads in future scans. The export function creates a plain text file with the selected thread keys (subject|sender). All operations are client-side and do not send any data externally.

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—label history, custom label name, and auto-scan preference—are persisted locally using GM_setValue, so your data remains intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script extracts threads from page text and helps you track which threads you've labeled. It does not actually apply labels to your Gmail account—it's a tracking tool to help you organize and remember which threads you've labeled. The extraction relies on the current text patterns on the page—if Gmail updates its UI, the script may need to be updated. The script does not access your Gmail 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.