Gmail Unsubscribe Link Finder

WHAT IT DOES

This script scans Gmail messages for unsubscribe links and displays a prominent "Unsubscribe" button in the email toolbar. When you open an email from a mailing list or promotional sender, the script automatically searches the email body for links containing "unsubscribe," "opt-out," "manage subscription," or "email preferences." It also detects List-Unsubscribe headers and mailto:unsubscribe links. When an unsubscribe link is found, a red "Unsubscribe" button appears near the email toolbar. Clicking the button opens the unsubscribe link in a new tab, making it easy to stop unwanted emails without hunting through the message for the tiny unsubscribe link. The script stores a history of recently used unsubscribe links for reference.

WHERE IT RUNS

The script runs on Gmail (mail.google.com). It works on the message view when you open individual emails. It supports both desktop and mobile views and updates dynamically as you navigate between messages.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- The "Enable unsubscribe finder" toggle enables or disables the script.

- Toggle "Show confirmation before opening" to enable or disable a confirmation dialog before opening the unsubscribe link.

- The "History" section shows recently used unsubscribe links.

When you open an email that contains an unsubscribe link, an "Unsubscribe" button appears in the email toolbar. Click the button to open the unsubscribe link in a new tab. You can also click "Refresh current email" in the panel to manually re-scan the message.

TECHNICAL SECTION — REAL MECHANISM

The script detects Gmail message views by looking for email body containers such as .a3s, .a3s.aiU, .msg-body, .gmail-body, and .ii.gt. It scans all anchor elements inside the email body and checks each link's href and text content for keywords like "unsubscribe," "opt-out," "manage subscription," "email preferences," and "remove me." Links with "unsubscribe" in the href or text are prioritized. The script also looks for link elements with rel="List-Unsubscribe" to extract unsubscribe URLs from email headers. Additionally, it detects mailto:unsubscribe links. The first matching link is selected and a button is injected into the email toolbar, which is found using selectors like .adn .ads, .gmail-actions, or .gnv. The button is styled with a red theme and uses event listeners to handle clicks. A confirmation dialog is shown if enabled, and GM_openInTab is used to open the link in a new tab. The unsubscribe URL is saved to a history list stored via GM_setValue, with a maximum of 50 entries.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. All settings save automatically via GM_setValue.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. Gmail frequently updates its interface, which may affect the selectors used to find the email body and toolbar. If the Unsubscribe button stops appearing, please check for script updates. The script scans the visible email content and may not detect unsubscribe links that are hidden behind collapsed sections or images. The script does not automatically unsubscribe you—it only finds and opens the link for you to complete the unsubscribe process. The script stores only your preferences and a history of unsubscribe URLs via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.