If you want to get the maximum control out of the tabs in Bagnon or Bagnonium, creating macro filters is the way to do it. We recommend you start by checking the code of the filters that come pre-installed with the addon. You can do this in-game to see real examples in action.

A macro filter is a short piece of code written in Lua. It is run once for each item slot in your bags. The macro decides whether to show or hide each slot.
All your macro has to do is return a true or false statement:

• true - show this slot
• false - hide this slot

Here’s the simplest possible macro:

return true

This tells the addon to show every item slot — no filtering at all.
Let’s make it more interesting.

Suppose you only want to show the first slot of every bag. You can do that with this:

return slot == 1

This will be a true statement only for the first slot of each bag. Everything else will be hidden.
All filters follow this same idea: you write a condition that tells the game whether to show an item slot.

Here are a few more examples to get you started:

You can copy and paste these codes ingame to try them out.

Each time your macro runs, it receives information about one specific item slot to make a decision on. You can use the following built-in variables in your macro:

The info table contains useful details about the item, including:

• info.stackCount — How many of the item are stacked in the slot
• info.isBound — Whether the item is soulbound
• info.quality — The item's rarity
• info.itemID — The ID of the item

You can learn more about this data here: API_C_Container.GetContainerItemInfo

If you're feeling confident, you can also use any of the regular WoW functions in your macro, such as:

• C_Item
• C_Container

These let you get even more advanced information about the item, such as if it's soulbound, what its name is, and so on.
But don’t worry about those if it is too much for you. You can do a lot with just the simple values shown above!