Wow API Talents

Talents & Specialization API (Retail — Patch 12.0.0)

Comprehensive reference for class talents, hero talents, the traits system, and specialization APIs.

Source: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API Current as of: Patch 12.0.0 (Build 65655) — January 28, 2026 Scope: Retail only.

Scope

• C_ClassTalents — Talent loadouts, config management
• C_Traits — Trait system (nodes, entries, configs, currencies)
• C_SpecializationInfo — Specialization queries
• Global Spec Functions — GetSpecialization, SetSpecialization
• Profession Specialization — C_ProfessionSpecUI (cross-ref professions skill)

Architecture Overview

The talent system uses a layered architecture:

1. Specialization — Top level: player picks a spec (e.g., Fire Mage)
2. C_ClassTalents — Manages loadouts (saved talent builds) and provides high-level talent tree interaction
3. C_Traits — Low-level trait system: nodes, entries, definitions, configs, currencies
4. Hero Talents — Sub-trees within the talent system, selected as a package

C_ClassTalents — Talent Loadouts & Config

Loadout Management

Talent Import/Export

Talent Commit

C_Traits — Core Trait System

Config Functions

Tree Functions

Node Functions

Node Info Fields

The nodeInfo table from GetNodeInfo():

• ID — Node ID
• posX, posY — Position in tree
• type — Node type (Single, Tiered, Selection, SubTreeSelection)
• maxRanks — Maximum ranks
• activeRank — Current active rank
• currentRank — Current rank (may differ from active during editing)
• entryIDs — Available entries (for choice nodes)
• activeEntry — Currently active entry
• currentEntry — Entry during editing
• canPurchaseRank — Can purchase next rank
• canRefundRank — Can refund a rank
• isAvailable — Node unlocked
• isCascadeRepurchasable — Can cascade repurchase
• isVisible — Visible in UI
• meetsEdgeRequirements — Edge requirements met
• groupIDs — Associated groups
• visibleEdges — Connected edges
• conditionIDs — Conditions for availability
• subTreeID — Sub-tree ID (hero talents)

Entry Functions

Entry Info Fields

• definitionID — The talent definition
• type — Entry type
• maxRanks — Max ranks for this entry
• isAvailable — Is this entry available
• conditionIDs — Conditions

Definition Info Fields

• spellID — Spell granted by this talent
• overrideName — Override display name
• overrideSubtext — Override subtext
• overrideIcon — Override icon

Condition Functions

Currency Functions

Global Specialization Functions

C_SpecializationInfo

Common Patterns

Get Active Spec Info

local specIndex = GetSpecialization()
if specIndex then
    local specID, specName, specDesc, specIcon, specRole = GetSpecializationInfo(specIndex)
    print("Current Spec:", specName, "Role:", specRole)
end

Iterate Talent Tree Nodes

local configID = C_ClassTalents.GetActiveConfigID()
if configID then
    local specID = PlayerUtil.GetCurrentSpecID and PlayerUtil.GetCurrentSpecID()
                   or GetSpecializationInfo(GetSpecialization())
    local treeID = C_ClassTalents.GetTraitTreeForSpec(specID)
    if treeID then
        local nodeIDs = C_Traits.GetTreeNodes(treeID)
        for _, nodeID in ipairs(nodeIDs) do
            local nodeInfo = C_Traits.GetNodeInfo(configID, nodeID)
            if nodeInfo and nodeInfo.isVisible and nodeInfo.activeRank > 0 then
                local entryInfo = C_Traits.GetEntryInfo(configID, nodeInfo.activeEntry.entryID)
                if entryInfo then
                    local defInfo = C_Traits.GetDefinitionInfo(entryInfo.definitionID)
                    if defInfo then
                        local spellName = C_Spell.GetSpellName(defInfo.spellID)
                        print(spellName, "Rank:", nodeInfo.activeRank)
                    end
                end
            end
        end
    end
end

Export/Import Talent String

-- Export current talents
local exportString = C_ClassTalents.GetLoadoutExportString()
print("Talent string:", exportString)

-- Import talents (must be out of combat)
local success, loadoutInfo = C_ClassTalents.ImportLoadout(exportString)
if success then
    C_ClassTalents.ViewLoadout(loadoutInfo)
end

Switch Specialization

local function SwitchSpec(specIndex)
    if specIndex ~= GetSpecialization() then
        if not InCombatLockdown() then
            SetSpecialization(specIndex)
        else
            print("Cannot change spec in combat")
        end
    end
end

Key Events

Gotchas & Restrictions

1. configID is per-spec — Each specialization has its own set of configs. Active configID changes on spec switch.
2. Cannot change talents in combat — C_ClassTalents.CommitConfig() and SetSpecialization() fail in combat.
3. Trait system is generic — C_Traits is the underlying system used for class talents, hero talents, AND profession specializations. The configType differentiates them.
4. Node types matter — Single nodes have one entry, Selection (choice) nodes have multiple entries you pick between.
5. Hero talents are sub-trees — Hero talent selection is a SubTreeSelection node type. Use C_Traits.GetSubTreeInfo().
6. GetNodeInfo is expensive — Cache node info when iterating the full tree. Don't call in OnUpdate.
7. Loadout export is opaque — The export string format is internal. Use the API functions, don't parse manually.
8. specIndex vs specID — GetSpecialization() returns an index (1-4), not a specID. Use GetSpecializationInfo() to get the specID.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.