filters retail

How filtering works in ElvUI for Midnight

Filter strings are used to restrict the buffs/debuffs to be displayed
Every filter string must start with HARMFUL (for debuffs) or HELPFUL (for buffs)
Each filter restricts the buffs/debuffs selected further, separated by a separator |
Example is HARMFUL|CROWD_CONTROL|PLAYER to select CC applied by the current player

If you join strings together without using the correct logic you may not see any auras at all
Example of a bad string: HELPFUL|IMPORTANT|CROWD_CONTROL|BIG_DEFENSIVE
That translates into "The aura is a buff which is important, a cc and big defensive" at the same time Impossible

It is possible to add a NOT statement to a filter string using ! like so !CROWD_CONTROL

ElvUI offers up to 8 tabs of filter sets (named as roman numerals: I to VIII)
All active green-colored tabs combined is what will show up on the main container
That's because you can't display everything you want with just one single filter string
It also means that, without fully understanding this new Blizzard system, you might see duplicate icons when a spell would return true in multiple of your filter set tabs.
For 99% of cases we recommend to stick to our optimized default setups (also available via the Reset Filters button).

Enabling one or more checkboxes such as Player or Pet or Stealable adds the statement as an AND requirement
For example HELPFUL + enabled checkbox for Use: Allow will display all Buffs added via ID in Allow List (default: Whitelist)
And HARMFUL + enabled checkbox for Use: Block will display all Debuffs except the IDs in Block List (default: Blacklist)

The following *Blizzard restrictions|r apply at all times:

1. Allow List is limited to "You can only allow Buffs on friendly units via ID"
2. Block List is limited to "You can only block Debuffs on enemy units via ID"
3. You can NOT allow Debuffs on friendly units
4. You can NOT block Buffs on enemy units

Filter setup examples

Show all Buffs you can apply except if their duration is longer than 5 minutes:
HELPFUL|PLAYER + Maximum Duration 300 + Player or Pet enabled (colored checkbox)

Show only Buffs which are tracked on the Whitelist filter:
HELPFUL + Allow List: Whitelist + Use: Allow enabled (colored checkbox)

Show only Debuffs applied by yourself except CC:
HARMFUL|PLAYER|!CROWD_CONTROL + Maximum Duration 0 + Player or Pet enabled (colored checkbox)

Show all your important hots and shields:
HELPFUL|RAID_IN_COMBAT|PLAYER + Maximum Duration 300

Show only Debuffs which your current talent setup can dispel:
HARMFUL|RAID|PLAYER + Maximum Duration 0

Show Debuffs which anyone in your party or raid can dispel:
HARMFUL|RAID_PLAYER_DISPELLABLE + Maximum Duration 0

Valid filter strings

HELPFUL
Require it to be a Buff

HARMFUL
Require it to be a Debuff

PLAYER
Require unit: "Player"(You), "Pet"(Yours), "Vehicle"(Yours)

RAID
If configuring Buffs: "Player"(You) can apply this aura
If configuring Debuffs: "Player"(You) can dispel it

RAID_PLAYER_DISPELLABLE
If configuring Buffs: Someone in your party or raid can purge or steal it
If configuring Debuffs: Someone in your party or raid can dispel it

RAID_IN_COMBAT
When combined with HELPFUL and PLAYER it will show self-cast hots and shields
Whats being displayed matches the ElvUI Aura Indicator (Class) list in the Filters Dropdown

CANCELABLE
Works on HELPFUL|PLAYER to show Buffs "Player"(You) can click off / cancel with right-click

INCLUDE_NAME_PLATE_ONLY
When added to the string, include nameplate-only flagged auras

EXTERNAL_DEFENSIVE
You can use /dump C_Spell.IsExternalDefensive(ID) and replace ID with the numeric ID of your test aura
This will print either true or false in your ingame chat then you'll know if its considered a external defensive or not
Some examples: Pain suppression, Iron Bark, Life Cocoon

CROWD_CONTROL
You can use /dump C_Spell.IsSpellCrowdControl(ID) and replace ID with the numeric ID of your test aura
This will print either true or false in your ingame chat then you'll know if its considered CC or not
Some examples: Fear, Polymorph, Entangling Roots

BIG_DEFENSIVE
You can use /dump C_UnitAuras.AuraIsBigDefensive(ID) and replace ID with the numeric ID of your test aura
This will print either true or false in your ingame chat then you'll know if its considered a big defensive or not
Some examples: Ice Block, Bubble, Blur, Barkskin

IMPORTANT
You can use /dump C_Spell.IsSpellImportant(ID) and replace ID with the numeric ID of your test aura
This will print either true or false in your ingame chat then you'll know if its considered important or not
Those are also special helpful auras that show on enemy even if non-stealable

DISPELLABLE
Displays auras which are dispellable, purgable or stealable. Regardless if your party or raid setup can handle it

Filter checkboxes

Those candidate checkboxes have multiple states:

1. Include (colored checkbox)
2. Exclude (grey checkbox)
3. Not used (empty checkbox)

---

Player or Pet
From any player or pet
Adds {isFromPlayerOrPlayerPet = true}

Role
Role aura - Tank/Heal/DPS
Adds {isRoleAura = true}

Priority
Priority aura
Adds {isPriorityAura = true}

Stealable
Stealable
Adds {isStealable = true}

NP: All
Nameplate: Show all
Adds {nameplateShowAll = true}

NP: Personal
Nameplate: Personal
Adds {nameplateShowPersonal = true}

Can Apply
Can apply aura
Adds {canApplyAura = true}

Boss
Boss aura - important stuff, was used for damage increase on Alleria P1 adds
Adds {isBossAura = true}

Boss or Role
The "either-or" between Role and Boss
Adds {isBossOrRoleAura = true}