ProtonMail Bulk Label Assigner

WHAT IT DOES

ProtonMail Bulk Label Assigner solves a common email organization challenge: assigning labels to multiple ProtonMail emails is tedious when done one at a time. While ProtonMail allows individual label assignment, there is no native way to apply labels to many emails simultaneously. This tool reads your current ProtonMail inbox view, detects all visible emails, and displays them in a scrollable checklist with subject lines, senders, and current labels. You select the emails you want to label, enter one or more labels separated by commas, and choose an operation mode: Add Labels (preserve existing labels), Replace All Labels, or Remove Labels. The tool then processes each selected email sequentially through ProtonMail's API, updating the email labels. Auto-completion suggests existing labels from your ProtonMail account as you type, and a preview shows your selection before you confirm.

WHERE IT RUNS

This extension panel runs directly inside your browser as an overlay on any ProtonMail inbox view. It works on the inbox, folder views, and search results. The tool detects emails from the page's DOM and uses ProtonMail's API (via GM_xmlhttpRequest) for label updates. It requires no additional API keys beyond your existing authenticated session — the tool extracts your access token from the page.

HOW TO USE

After installing the BotGentz extension and activating ProtonMail Bulk Label Assigner, navigate to your ProtonMail inbox. Click the extension icon in your browser toolbar to open the panel. The tool automatically detects all emails displayed on the current page. Each email appears with its subject, sender, and current labels alongside a checkbox. Use the "Select All" toggle or individually check emails. Next, enter your labels in the text field, separated by commas (e.g., "Work, Urgent, Finance"). The tool suggests existing labels as you type. Choose your operation mode: "Add Labels (keep existing)" to add new labels while preserving current ones, "Replace All Labels" to overwrite all existing labels, or "Remove Labels" to delete specific labels from selected emails. The preview section shows how many emails are selected and which labels will be applied. Finally, click "Apply Labels." The tool processes each email with a 500ms delay, showing progress as each email is updated. A notification appears when all emails are processed.

TECHNICAL OPERATION — ProtonMail API Label Updates

This tool uses ProtonMail's API to perform label updates reliably. It first extracts the user's access token from the page (using regex to find `access_token` in scripts or meta tags), then constructs a PUT request to `/mail/v4/messages/{emailId}` with a payload containing the `Labels` array. Based on the selected mode, the tool merges, replaces, or filters labels: Add mode preserves existing labels and appends new ones; Replace mode overwrites all labels; Remove mode filters out the specified labels. The API approach is more reliable than DOM-based simulation because it works independently of ProtonMail's UI structure, supports proper error handling with HTTP status codes, and can handle large numbers of emails efficiently without triggering UI event delays. A 500ms delay between updates prevents rate limiting and API congestion.

THE PANEL

The extension panel is fully draggable and remembers its position per site session. It snaps to the nearest edge of the browser viewport when dragged within 50 pixels of any side. You can collapse the panel to a compact title bar using the minimize button, preserving your selection state. The panel resizes vertically by dragging the bottom edge. Press the Escape key to close the panel instantly without losing your email selection. The preview updates in real-time as you select emails, enter labels, or change modes.

PLEASE NOTE

This tool requires the free BotGentz extension to function. The script uses ProtonMail's API and requires your session to be authenticated. It does not store, transmit, or log any email data, label information, or user activity. All API requests are made locally from your browser session. The tool relies on extracting your access token from the page, which may expire if your session times out. ProtonMail may update its DOM structure over time, which could affect email detection; we monitor and release compatibility updates as needed. Label changes are permanent — review the preview carefully before confirming. Export formats include CSV and JSON for maximum compatibility with analysis tools. Ensure you're on a ProtonMail inbox page for the tool to detect emails correctly.