Gmail Bulk Forward to Address

WHAT IT DOES

This userscript helps you forward multiple email threads at once to a specified email address. 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 forward to a specified email address. It shows the subject and sender of each thread, filters by existing labels or read status, and maintains a list of already forwarded threads to avoid duplicates. It exports the list of selected threads and provides a confirmation step before taking action. The script simulates the forward action by opening a new compose window with the selected threads' subjects and a note.

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 forward history are stored locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Enter the email address you want to forward to in the "Forward to email address" field. Click "Scan for threads" to extract email threads from the current page. The panel displays a list of threads with checkboxes, showing the subject and sender. Select the threads you want to forward—use "Select All" to choose all. Click "Forward Selected" to open a Gmail compose window with the selected threads listed in the body. Click "Export Selected" to download a text file with the selected thread information. Use "Clear History" to reset the forward 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) and sender (looking for "From:" patterns and email addresses). It deduplicates threads by subject and sender. The forward action opens a Gmail compose window using the URL format: https://mail.google.com/mail/u/0/?view=cm&fs=1&to=address&su=subject&body=body. The body includes a list of the selected threads with subjects and senders. The script stores the forward history in GM_setValue so you don't see already-forwarded threads in future scans. 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—forward address, forward history, 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 forwarded. It opens a Gmail compose window—you'll need to manually send the emails. 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 and opens compose windows. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.