Automated updating of API pages at this location, to reflect patch changes, has ceased from 10.1.7 onwards.

This function is restricted. #nocombat - This cannot be called while in combat. Restricted since patch 4.0.1; Use /cancelaura Buff Name in macros, or SecureAuraHeaderTemplate if re-implementing buff frames.

Removes a specific buff from the character.

CancelUnitBuff(unit, buffIndex [,filter])

Arguments

unit

string : UnitId - The unit to cancel the buff from, must be under the player's control.

buffIndex

number - index of the buff to cancel, ascending from 1.

filter

string - any of combination of "HELPFUL|HARMFUL|PLAYER|RAID|CANCELABLE|NOT_CANCELABLE".

Details

• This function does not work for canceling druid forms, rogue Stealth, death knight presences, or priest Shadowform.

Patch changes

Patch 8.0.1 (2018-07-17): Removed ability to cancel by name and rank. Functionality replaced by CancelSpellByName.
Patch 4.0.1 (2010-10-12): Protected while in combat; tainted code cannot cancel stance-affecting buffs even while out of combat.
Patch 3.0.2 (2008-10-14): Replaced CancelPlayerBuff.