WoW API: UnitRace

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < UnitRaceReturns the race (Tauren, Orc, etc) of the specified unit.

race, raceEn = UnitRace("unit");

---

Arguments

("unit")

unit

String - The UnitId to get information from.

---

Returns

race

The localized race of the specified unit as a string. e.g. Tauren, Orc etc.

raceEn

The race in english as a string. Possible returns are: "Human", "NightElf", "Dwarf", "Gnome", "Draenei", "Worgen", "Orc", "Troll", "Scourge", "Tauren", "BloodElf", "Goblin", "Pandaren". As of Patch 7.3.5, Allied Races return: "VoidElf", "LightforgedDraenei", "HighmountainTauren" and "Nightborne".

(Note for undead: race returns "Undead" but raceEn returns "Scourge")

See also: https://wow.gamepedia.com/RaceId

---

Example

local race = UnitRace("player");
ChatFrame1:AddMessage('Your player is a : ' .. race .. );

Result

Prints the player's race to the chat frame as

'Your player is a : Tauren'.  (Or whichever race the specified unit is)