Jira Bulk Label Applier

WHAT IT DOES

Jira Bulk Label Applier is a browser extension that automatically scans the current webpage for Jira issues, issue keys, summaries, labels, and list view items. It detects Jira issue elements by examining class names, IDs, data attributes, and text patterns for Jira issue keys (e.g., PROJECT-123), summaries, and label indicators. The extension adds a floating "bulk label" button (🏷️) next to each detected issue element, allowing you to select individual issues for bulk labeling, capture issue key, summary, and current labels. Clicking the button toggles the selection state, and selected issues are added to a bulk collection. The main panel allows you to enter labels to apply (comma-separated), choose an operation mode (Add labels, Replace all labels, or Remove labels), add notes about the labeling reason, and apply the labels to all selected issues in configurable batches. The extension updates label indicators on the page and logs each label change to the local database with added labels, removed labels, notes, and tag groups. The main panel displays all saved label changes with issue keys, summaries, added/removed labels, notes, and tags. All data is stored locally in your browser using GM_setValue, ensuring your label history persists across page reloads and browser sessions. This helps Jira administrators, project managers, team leads, and anyone using Jira to perform bulk label application directly from issue lists without using ScriptRunner or third-party tools, saving time on issue categorization and workflow management.

WHERE IT RUNS

This extension runs on any Jira page that displays issue lists, issue keys, summaries, labels, or board views – including Jira Software project boards, backlog views, filter results, issue search pages, agile boards (Scrum/Kanban), and any page containing Jira issue data. The extension intelligently adapts to different page structures and supports a wide range of common Jira display patterns. No manual configuration is required per site; the extension automatically detects issue elements using a flexible pattern matching system. This makes it ideal for Jira administrators, project managers, and team leads who need to perform bulk labeling directly from the Jira UI.

HOW TO USE

Simply install the extension and navigate to any Jira page displaying issues. The extension automatically detects issue elements and places a small "bulk label" button (🏷️) next to each one. Click any of these buttons to select that issue for bulk labeling – the button highlights to show it's selected. Click it again to deselect. As you select issues, a counter at the bottom-right shows how many you've collected. When ready, click the floating button (🔖) to open the main panel. Enter the labels you want to apply (comma-separated). Choose the operation mode: "Add labels" to append labels, "Replace all labels" to overwrite existing labels, or "Remove labels" to delete specific labels. Add a note about the labeling reason and optional tag group for organization. Click "Apply Labels to Selected" to start the bulk labeling process – the extension processes issues in batches (configurable size, default 10) to avoid performance issues, updating each issue's labels and logging the change. The panel also displays your label history for reference. Use the settings section to enable or disable auto-detection and set the batch size. The "Clear All History" button removes all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension employs a multi-layered detection system that identifies Jira issue information with high accuracy. First, it scans the DOM using a comprehensive set of CSS selectors targeting common issue-related class patterns, IDs, and data attributes. The issue key extraction uses regex pattern matching to identify Jira issue keys (PROJECT-123 format) from text, data attributes, and URL links containing "/browse/". The summary extraction identifies issue summaries from text patterns and data attributes. The current labels extraction uses multiple strategies: scanning for label-like words in text, examining label badge elements (lozenge, aui-label, ghx-label), and reading data attributes. Each tracked issue is assigned a unique ID based on the issue key, ensuring that history stays correctly associated. The bulk label process uses a batched approach with configurable batch size (default 10), processing issues in sequential batches with 300ms delays between batches to avoid performance issues. Three operation modes are supported: add (appends labels to existing), replace (overwrites all labels), and remove (deletes specific labels). A MutationObserver detects dynamic content updates and re-scans only when new issue elements appear, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The bulk label application panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during issue management. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The label history and settings are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your Jira workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause issue detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all label data, label history, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. This extension is not affiliated with, endorsed by, or sponsored by Atlassian or Jira. You are responsible for backing up your label history data if you switch browsers or clear your storage. The extension does not read, modify, or interfere with any Jira data, issues, or functionality beyond the page content – it operates on the static page content and stores only metadata (issue keys, summaries, label changes, and notes) that you explicitly create. Use this tool responsibly and in accordance with your organization's data handling policies.