[Share] Remove a set of tags completely from a library

[mjthoraval]

Description

Remove a set of tags completely from a library.
Consider using this more flexible script to delete the tags only from the selected items, collection or library: #580.

The current code is designed to be used with this other script: #577.
But it can be adapted for any set of tags.

Caution

This script will completely remove the tags in TAGS_TO_DELETE from the library.
This cannot be undone. Please use carefully.

Event

None

Operation

Script

Data

/**
 * Delete multiple tags from the entire library.
 * @author mjthoraval with Claude AI
 * @usage From the Tools Menu
 * @link https://github.com/windingwind/zotero-actions-tags/discussions/579
 * @version v1.0, 3 March 2026
 */

// Only run once (when triggered at collection/library level, not per-item)
if (item) return;

const TAGS_TO_DELETE = [
  "#A🟨",
  "#A🟥",
  "#A🟩",
  "#A🟦",
  "#A🟪",
  "#A🩷",
  "#A🟧",
  "#A🩶",
  "#Yellow💛",
  "#Red❤️",
  // Add more tags here...
];

if (TAGS_TO_DELETE.length === 0) {
  return "Error: Please add at least one tag to the list.";
}

const libraryID = Zotero.Libraries.userLibraryID;
const allItems = await Zotero.Items.getAll(libraryID);

let totalRemoved = 0;

await Zotero.DB.executeTransaction(async () => {
  for (const tag of TAGS_TO_DELETE) {
    const matchingItems = allItems.filter(i =>
      i.getTags().some(t => t.tag === tag)
    );

    for (const i of matchingItems) {
      i.removeTag(tag);
      await i.save();
      totalRemoved++;
    }
  }
});

return totalRemoved > 0
  ? `✅ Done: removed ${totalRemoved} tag(s).`
  : `⚠️ No matching tags found.`;

Anything else

No response