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.