UnitFactionGroup

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Flavors
war within  mainline  cata  wrath  vanilla
Links
Blizzard Docs  Townlong Yak  Offline /api  Wowprogramming  GitHub Search
Info
Added in 1.0.0 / 1.13.2

Returns the faction (Horde/Alliance) a unit belongs to.

englishFaction, localizedFaction = UnitFactionGroup(unit)

Arguments

unit

string : UnitId

Returns

englishFaction

string - Unit's faction name in English, i.e. "Alliance", "Horde", "Neutral" or nil.

localizedFaction

string - Unit's faction name in the client's locale or nil.

Details

• The function returns may not return correct results until after PLAYER_ENTERING_WORLD event for units other than "player".
• Note that for NPCs, the function will only return Alliance/Horde for factions closely allied with either side. Goblins, for instance, return nil,nil.
• Pandaren player characters on the Wandering Isle return "Neutral", "".