ElvUI Bag Categories

Splits ElvUI's bag and bank windows into labeled, collapsible categories — Quest Items, Currency, Soulbound gear, Trade Goods, and a dozen more — instead of one long grid of icons, with a drag-to-reorder sort, per-category on/off switches, and an optional running gold total.

• Overview
• Category model
• Configuration
• ItemRack equipment sets
• Bag & bank value
• Slash commands

Overview

By default, ElvUI's bag window is a single grid: every item from every bag, in whatever order the game hands them to you, cut off by a fixed number of columns. Bag Categories reads the same slot data ElvUI already has and re-lays it out as a stack of labeled sections instead — each with its own header, its own item count, and its own show/hide toggle. The same grouping applies to the bank window, controlled by a separate switch.

Every item is placed by a single classification pass per slot: item class, subclass, bind state, and (for a few categories) whether it's tied to a quest currently in your log, is marked as junk, or is a bag key versus a keyring key. Trade Goods and Recipes go one step further and split themselves live by the item's real in-game subtype text — the same string the tooltip and auction house show — so a material or profession list never drifts out of sync with the game's own data.

A grouped bag window. Soulbound gear is further split into per-set panels — Feral Tank and Restoration — picked up automatically from ItemRack.

At extra width, sibling categories share a row — here Equipment/Miscellaneous, and Feral Tank/Restoration nested underneath.	A newly-created ItemRack set (Feral DPS) and a live Trade Goods subtype (Cloth) both appear without any manual setup.

Configuration

Configuration lives inside ElvUI's own settings tree, under a Bag Categories entry in the left-hand list — no separate config addon required. The same panel also opens as a small standalone window via /bagcategories config, for tweaking things without ElvUI's full settings frame open.

The options panel, docked inside ElvUI's own settings tree.

Top-level options

Categories & sort order

Below the top-level options sits the full category list, in whatever order it's currently sorted. Three things happen here:

• Enable/disable — every category is a checkbox; unchecking one applies the fallback rule described above.
• Reorder — drag one category onto another to swap their positions. This works at every level: the root list, and again inside each category that has its own sub-panel (Soulbound, Trade Goods, Recipes). Order is shared between bag and bank.
• Drill into sub-panels — Soulbound, Trade Goods, and Recipes each expand into their own nested settings group (with their own Enable toggle at the top and their own drag list below) rather than showing every subcategory flattened into one long list.

Collapsing a section for the current session is done in the bag/bank window itself, not in the options panel: click the [-] in any category header to fold it shut (it becomes [+]); click again to reopen it. This state is remembered per category.

ItemRack equipment sets

If ItemRack is installed, every saved ItemRack set becomes its own subcategory under Soulbound → Equipment — a "Feral Tank" set built in ItemRack shows up as a matching Feral Tank panel in the bag, grouping exactly that gear together, wherever it's currently sorted under Soulbound.

• Read-only: this addon only reads ItemRack's saved sets, never writes to them.
• Internal ItemRack sets (prefixed ~, like its own "Unequip" set) are skipped.
• Matching is by the item's base ID, ignoring enchant/gem/suffix variations, so an enchanted or socketed copy of a set piece still lands in its set.
• A gear piece assigned to a set is filed under its set regardless of actual bind state — it's realistically soulbound either way.
• Refreshed on every layout pass, so a set added, renamed, or edited in ItemRack mid-session appears immediately, no reload needed.

Turn this off with Use ItemRack Categories in the options panel if you'd rather keep all equipment in one flat Equipment section.

Bag & bank value

When enabled, a running total (e.g. 51g 54s 97c) appears next to the slot count, added up from whichever pricing addon is selected as the Price Source. Every source is read-only against that addon's own data — nothing is fetched, scanned, or written on its behalf.

Only a source from an addon you actually have installed produces a value. Pick a source that isn't installed and the panel shows a warning inline instead of a silently blank total.

Slash commands

Bag Categories doesn't replace ElvUI's bag frame — it hooks Bags:Layout and Bags:UpdateSlot and re-lays out the same slot buttons ElvUI already created, every time ElvUI itself updates them. That re-layout runs synchronously, in the same frame, specifically so there's no visible flash back to the native ungrouped grid before the grouped one catches up.

Everything the addon needs to make a layout decision — the category tree, ItemRack's live set data, the classification rules, the saved sort order — is re-derived fresh on each pass, which is also why a brand-new ItemRack set or an unfamiliar trade-good subtype just appears correctly the next time the bag redraws, with nothing to reload.

Category model

Every category is a node on a tree, and every node's position in that tree is also its identity: a dot-joined path like soulbound.mounts.flying. That one string is simultaneously the saved-variables key for whether the category is enabled, whether it's currently collapsed, and its bucket key while items are being sorted into columns.

Default top-level order

Soulbound's children

Soulbound is the one top-level category with permanent sub-structure:

• Equipment — bound gear and relics. This is also where ItemRack equipment-set subcategories attach — see ItemRack equipment sets.
• Mounts — split into Flying and Ground. Off by default: mount bags fill up fast, and most players park them somewhere else, so this whole branch starts collapsed into plain Soulbound until you opt in.
• Other — the Soulbound catch-all: bound items that don't fit anywhere more specific land here instead of generic Miscellaneous, since "can't be traded" is the more useful fact about them.

Trade Goods & Recipes: live subtypes

These two read the item's actual subtype text at classification time — the same string the tooltip shows — rather than a hardcoded ID table, so they can't drift out of sync with the game:

Trade Goods splits by material (materials are shared across professions — Ore feeds Mining, Blacksmithing, Engineering, and Jewelcrafting alike):

Cloth Leather Metal & Stone Herb Meat Elemental Enchanting Jewelcrafting Miscellaneous

Recipes splits cleanly by profession, since each recipe subtype text is a profession name:

Alchemy Blacksmithing Cooking Enchanting Engineering First Aid Leatherworking Tailoring Fishing Jewelcrafting Poisons Miscellaneous

Anything reported under a subtype that isn't in these lists still gets grouped — under that parent's own Miscellaneous child — instead of being lost.

Unchecking a category never hides items

Turning a category off just collapses it into the nearest enabled ancestor. Unchecking a subcategory folds its items up one level; unchecking an entire top-level category (or an entire chain, all the way up) folds all the way down to Miscellaneous:

Flying (off) ← Mounts (off) ← Soulbound (on) → items land in Soulbound
Flying (off) ← Mounts (off) ← Soulbound (off) → items land in Miscellaneous

Example: with Flying and Mounts both unchecked but Soulbound itself checked, a flying mount lands in the plain Soulbound bucket. If Soulbound were unchecked too, it would fall all the way to Miscellaneous instead.

ElvUI Bag Categories · v1.0.0 · by ludvigaf · github.com/ludvigaf/ElvUI_BagCategories