LinkedIn Recruiter InMail Flag Highlighter

WHAT IT DOES

This script helps you quickly identify InMail messages sent by LinkedIn Recruiters in your messaging inbox. When a Recruiter sends you an InMail, the script detects it and applies a distinctive visual highlight—making it stand out from regular messages from connections or other senders. You can choose from three highlight styles: a colored left border, a background fill, or a "Recruiter" badge label. The highlight color is fully customizable, so you can pick a color that catches your eye. The script also counts how many Recruiter InMails are in your current conversation list and displays this count in the panel. This is especially useful for job seekers who want to prioritize recruiter outreach and ensure they never miss an important opportunity. Recruiter InMails are often time-sensitive, and this script helps you spot them instantly without having to scan through every message.

WHERE IT RUNS

The script runs on all LinkedIn domains (*.linkedin.com). It works in the main messaging interface (linkedin.com/messaging), individual message threads, popup message windows, and the message preview pane. It handles both desktop and mobile views. The script observes DOM mutations to detect when new messages are loaded as you scroll through conversations, and applies highlights to new Recruiter InMails automatically.

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 status display at the top shows how many Recruiter InMails have been found in the current view.

- Choose a highlight style from the dropdown: "Border (left colored border)," "Background (colored fill)," or "Badge (label on message)."

- Pick a highlight color using the color picker—choose any color that stands out to you.

- Click "Refresh messages" to manually re-scan the current conversation list and apply highlights to any new messages.

- Click "Reset to defaults" to restore the default highlight color (purple) and style (border).

The script works automatically once installed—just open your messages and Recruiter InMails will be highlighted based on your preferences.

TECHNICAL SECTION — REAL MECHANISM

The script identifies Recruiter InMails by scanning each message element for multiple indicators. It searches the message text for the word "Recruiter" and for "InMail" or "in mail" phrases. It also looks for specific CSS class names and data attributes that LinkedIn uses to mark Recruiter messages, such as those containing "recruiter" or "inmail" in their names. Additionally, it checks for ARIA labels that include "recruiter" or "Recruiter," and examines sender name elements for the word "Recruiter." When a Recruiter InMail is detected, the script applies the selected highlight style. For the "border" style, it adds a 4px solid border on the left side of the message. For the "background" style, it applies a semi-transparent background fill. For the "badge" style, it inserts a small "🔹 Recruiter" badge next to the sender's name. All highlighting is done using CSS classes and inline styles, and the script uses WeakSet to track processed messages and avoid duplicate work. The script also maintains a counter of detected Recruiter InMails and updates the status display in real time.

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. LinkedIn frequently updates its messaging interface and the way Recruiter messages are marked, which may break the script's detection logic. If Recruiter InMails are not being highlighted correctly, please check for script updates. The script stores only the highlight color and style preference via GM_setValue. No data is sent externally. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, classList, WeakSet) and never use innerHTML. The script does not modify message content or interact with LinkedIn's servers—it only applies visual highlighting to messages you are already viewing.