The short answer: choose the display, then test one aura
For the common elvui aura filters question, do not begin by importing a large profile or adding many conditions. Open ElvUI with /ec, select the display, decide whether it shows helpful buffs, harmful debuffs, or both, then test one known effect. This shows whether the rule works before several filters interact.
Aura Filters are display rules, not a replacement for the aura itself. If the effect is not present on the test unit, a correct filter can look broken. A missing icon can also come from the wrong display, inactive profile, branch-specific field, visibility condition, or another addon drawing a different group.
- Open
/ecoutside combat when possible. - Write down the display you are editing: player, target, focus, party, raid, or nameplate.
- Test with one effect that you can reliably create or observe.
- Change one filter or display setting at a time.
- Export the working profile before a broad cleanup or import.
Where ElvUI Aura Filters fit in the interface
The exact menu path depends on the display type and client branch, but the useful question is always the same: which frame or plate owns the aura row you are looking at? Player and target unit frames can have their own aura settings, while nameplates may use a separate display group and filter. If you change a target-frame rule while watching a nameplate, nothing appears to happen because the visible icons belong to another module.
Start with the display's aura section and locate the filter, whitelist, blacklist, or filter-tab control. The official ElvUI filter documentation describes current string conventions, but menu labels can move between branches. Use the active panel for the location and the documented prefix logic for the rule. The related ElvUI Nameplates guide helps when icons belong to floating plates.
Use a known source, visible target, and short duration for the first test. Apply one friendly buff or debuff, then compare the same aura row before and after the change. Avoid changing scale, sorting, anchoring, and visibility at the same time.
- 1
Open the active profile
Type
/ec, confirm the profile shown in the panel and open the unit or nameplate display that owns the aura row. - 2
Choose helpful or harmful
Decide whether the rule is for buffs, debuffs, or a separate group. Do not mix both meanings in the first test.
- 3
Find the filter control
Look for the filter name, whitelist, blacklist, or filter tabs inside that display. Menu labels may differ by branch.
- 4
Test one known effect
Apply or observe one effect, reload only if requested, and check the same unit at the same display.
- 5
Export after success
Save the working profile and note the display before adding more rules or importing another layout.
How to write and combine ElvUI filter strings
The most important rule is to begin with the correct type. Use HELPFUL for buffs and HARMFUL for debuffs, then add the spell, source, or other condition supported by the active filter. The official documentation also describes separators and the use of ! for a negative condition. Read the full filter as a rule, not as ordinary prose: a small punctuation mistake can make every aura fail the match.
When the display exposes several filter tabs, treat each active tab as another set of conditions. The current documentation explains that active tabs can combine, so a green tab may add a second path instead of replacing the first. This is useful for a healer who wants important dispellable effects plus personal cooldown buffs, but it can also create duplicates when two tabs allow the same aura.
Build the smallest useful rule first. Start with the type prefix and one known effect, verify it, then add a source or duration condition. If the rule stops working, remove only the last condition so the failing assumption is clear.
| Goal | Starting idea | What to verify |
|---|---|---|
| Show a friendly buff | Use the HELPFUL type and one known effect | The effect is actually on the unit you are testing |
| Show an enemy debuff | Use the HARMFUL type and a known target | The target can receive the debuff and the display owns the row |
| Hide one unwanted aura | Use a negative condition only after the positive match works | Punctuation and spacing follow the current filter documentation |
| Combine important groups | Use separate filter tabs for separate purposes | Two tabs do not allow the same effect twice |
| Debug a long rule | Remove conditions from right to left | The last removed condition identifies the failing assumption |
Fix a missing, duplicated, or cluttered aura
If an aura is missing, begin with the display and the effect, not the addon folder. Confirm that the unit is the one you intended, the profile is active, the aura row is enabled and the effect is currently present. Temporarily simplify the filter and remove duration, source, class, or combat conditions. If the icon returns, add the conditions back one at a time until the boundary is clear.
Duplicates usually come from overlapping filter tabs or two display systems showing the same effect. Compare the icon position, size and anchor. If one copy is on a unit frame and another is on a nameplate, the two filters may both be correct. If two icons occupy the same row, inspect active tabs and then test with Blizzard or a companion aura addon disabled. Do not delete the profile until you know which owner is drawing each copy.
Clutter is not always a filter failure. A correct rule can still show too many effects when the display has a high icon count, several tabs, or broad source conditions. Reduce the allowed set first, then tune sorting, size, and spacing.
| Symptom | Likely cause | Safe next check |
|---|---|---|
| No aura appears | Wrong display, inactive profile, or rule does not match | Test one known effect with a simplified filter |
| Only some effects appear | Type, source, duration, or branch condition is too narrow | Remove the last condition you added |
| The same aura appears twice | Two active tabs or two modules allow it | Disable one tab or display source for a controlled test |
| The screen is crowded | Broad rules, too many tabs, or a high icon count | Keep only decision-critical effects and reduce count |
| The rule worked before an import | The imported profile changed ownership or conditions | Compare a new profile with the exported working profile |
Profiles, Classic branches, and version boundaries
A profile stores configuration; it does not install missing fonts, media, WeakAuras, plugins, or another addon that happens to show a similar aura row. Export your working profile before importing a community setup, and import the new data into a separate profile first. If the new display is wrong, you can switch back without rebuilding every filter by hand. The site's ElvUI Profiles guide covers export, backup and profile-boundary checks.
Retail and Classic branches can expose different fields, protected frames, available auras, and menu labels. A rule that is valid for one client may be too broad, too narrow, or simply unavailable in another. Keep the branch in your notes, test an effect that actually exists in that client, and avoid copying a screenshot or filter string without checking its source context.
This page does not claim a latest ElvUI version. The official Tukui distribution page was checked on September 15, 2026 for first-party context; filter mechanics come from the official documentation, while labels can change. For clean replacement, use the update guide and keep WTF until the filter is tested.
- Export before changing several filter tabs at once.
- Keep Retail and Classic profiles separate when their displays differ.
- Do not treat a profile string as an addon or media download.
- Test the base ElvUI display before enabling a companion aura addon.
- Note the display, profile, branch, and test effect.
ElvUI Aura Filters FAQ
What are ElvUI Aura Filters used for?
They control which buffs and debuffs appear in a specific aura display. Choose the correct unit frame or nameplate group, then test a known effect before adding more conditions.
How do I show buffs with ElvUI Aura Filters?
Use the active display's filter control and begin with the HELPFUL type described in the current official documentation. Test one friendly buff that is actually present on the unit you are watching.
How do I filter debuffs in ElvUI?
Use the HARMFUL type for debuffs, select the display that owns the row and add conditions gradually. If the icon is missing, simplify the rule and confirm the target can receive the effect.
Why is an ElvUI aura not showing?
The usual causes are the wrong display, an inactive profile, an effect that is not currently present, an overly narrow condition, or another module drawing a different row. Simplify the filter and test one known aura first.
Why do ElvUI Aura Filters show duplicate icons?
Two active filter tabs or two display systems may allow the same effect. Disable one tab or one display source for a controlled test, then keep only the rule that matches the intended location.
Can I use the same Aura Filter on Retail and Classic?
Not always. The branches can expose different fields, protected frames, and menu labels. Keep separate profiles and test an effect in the client you actually launch.
Sources and practical limits
The filter-string rules were checked against the official ElvUI Retail Filters documentation, which describes HELPFUL and HARMFUL prefixes, separators, negative conditions and filter-tab behavior. Use that page for the current rule syntax, and use the active in-game panel for the exact menu path in your client branch.
The official Tukui ElvUI distribution page was checked on September 15, 2026 as the first-party download context. This article does not invent a version, file size, mirror, or direct download URL. The three local images are text-free editorial illustrations generated for explanation; they are not official ElvUI screenshots or proof of a particular menu state.