Wow API Guild

Guild API (Retail — Patch 12.0.0)

Comprehensive reference for guild management, guild bank, and guild info 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

• Guild Management — Invite, promote, demote, kick, disband, MOTD
• Guild Roster — Member list, info, sorting
• Guild Bank — Item management, tabs, permissions
• C_GuildInfo — Guild info utilities
• Club Integration — Guilds as C_Club entities

Guild Management

Core Functions

Guild Roster

C_GuildInfo

Guild Bank

Guild Bank Items

Guild Bank Tabs

Guild Bank Log

Guild + Club Integration

Guilds are represented as clubs with Enum.ClubType.Guild in the C_Club system:

-- Get guild as a club
local clubs = C_Club.GetSubscribedClubs()
for _, club in ipairs(clubs) do
    if club.clubType == Enum.ClubType.Guild then
        local guildClubId = club.clubId
        -- Use C_Club functions for guild chat streams
        local streams = C_Club.GetStreams(guildClubId)
        break
    end
end

Common Patterns

Iterate Guild Roster

local function PrintGuildMembers()
    local numMembers = GetNumGuildMembers()
    for i = 1, numMembers do
        local name, rankName, rankIndex, level, classDisplayName, zone,
              publicNote, officerNote, isOnline = GetGuildRosterInfo(i)
        if isOnline then
            print(name, level, classDisplayName, zone)
        end
    end
end

-- Must request roster first
C_GuildInfo.GuildRoster()

Guild Bank Interaction

-- List items in guild bank tab 1
local function ListGuildBankTab(tab)
    local numSlots = GetGuildBankNumSlots(tab)
    for slot = 1, numSlots do
        local texture, itemCount, locked, isFiltered, quality = GetGuildBankItemInfo(tab, slot)
        if texture then
            local link = GetGuildBankItemLink(tab, slot)
            print(link, "x" .. (itemCount or 1))
        end
    end
end

Key Events

Gotchas & Restrictions

1. Roster request required — Call C_GuildInfo.GuildRoster() before reading roster. Data isn't always current.
2. Guild bank requires NPC — Guild bank functions only work when at a guild bank NPC.
3. Permissions vary by rank — Check permissions before attempting operations. CanGuildBankRepair(), CanWithdrawGuildBankMoney(), etc.
4. QueryGuildBankTab is async — Must query each tab and wait for GUILDBANK_UPDATE_TABS before reading items.
5. Guild = Club — Guild chat uses C_Club with Enum.ClubType.Guild. Use C_Club.SendMessage() for guild chat.
6. Rank indices — Rank 0 = Guild Master. Higher indices = lower ranks.
7. GetGuildRosterInfo index — 1-based index into the roster. Not related to rank or any other ordering.
8. MOTD event timing — GUILD_MOTD fires during login. Register early to catch it.

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