Trello Bulk Label Assigner

WHAT IT DOES

This tool enables you to efficiently add, remove, or toggle labels on multiple Trello cards in bulk. You select a source list (or "All Lists"), and the script scans the board, displays all cards from that list in a scrollable list with titles, current labels, and list names with checkboxes. You specify a label by name (e.g., "Urgent") or color (e.g., "#ff0000") and choose whether to add, remove, or toggle the label on selected cards. The script navigates to each card's detail page, opens the labels picker, finds the matching label, and applies the action. This is especially useful for bulk-categorizing cards by priority, project, status, or any other label-based organization system.

WHERE IT RUNS

The script runs directly inside the Trello web interface (trello.com). It does not require a separate extension popup, background process, or external server. Everything happens within the page context, interacting with Trello's DOM components.

HOW TO USE

1. Open a Trello board in your browser.

2. Open the BotGentz panel.

3. Click "Scan Board for Lists" to detect all lists on the current board. The source list dropdown will populate with list names.

4. Select a source list (the list containing the cards you want to label) or choose "All Lists" to scan the entire board.

5. Enter a label name or color in the "Label name or color" field (e.g., "Urgent", "Q4", "#ff0000").

6. Select the action: "Add Label", "Remove Label", or "Toggle Label".

7. Click "Scan & Apply" to start the process.

8. The script will scan the board, display cards from the source list in a list with checkboxes, showing titles, current labels, and list names.

9. Select the cards you want to label (all are checked by default).

10. Click "Apply Labels" to begin. The script will open each card, open the labels picker, find the matching label, and apply the action.

TECHNICAL MECHANISM

Unlike Trello's built-in label management (which is card-by-card), this script operates purely on the public DOM of the Trello interface. It identifies lists using selectors like `[data-list-id]` or `[class*="list-wrapper"]`, and cards using `[data-card-id]` or `[class*="card"]`. Card details (title, current labels) are extracted from the card elements. Label matching supports both label names (text content) and hex colors (style matching). For each card, the script uses event-driven interaction: it clicks the card to open the detail modal, locates the Labels button (using aria-labels or text content), opens the label picker, finds the matching label by name or color, and clicks it based on the selected action (add/remove/toggle). All actions include retry logic with spacing to account for Trello's asynchronous rendering and to avoid triggering rate limits.

THE PANEL

The tool appears as a draggable, resizable panel on the side of your screen. You can drag it to any position by clicking and holding the header, resize it by dragging the bottom-right corner, and collapse it to a small bubble when not in use. Press the Escape key to close the panel. The panel remembers its position and size per site so it stays where you left it on your next visit.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not store any personal data except for a list of ignored card IDs, which is saved locally in your browser using GM_setValue. No data is sent to any external server. Trello frequently updates its interface, which may break the script. If you encounter issues, check for updates or contact support. Label names must match exactly as they appear in Trello (case-sensitive). The script works on Trello boards you have edit permissions for.