GetExpansionLevel

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 3.3.0 / 1.13.2

Returns the expansion level currently accessible by the player.

expansionLevel = GetExpansionLevel()

Returns

expansionLevel

number - The newest expansion currently accessible by the player.

NUM_LE_EXPANSION_LEVELS

Value	Enum	Description
	LE_EXPANSION_LEVEL_CURRENT
0	LE_EXPANSION_CLASSIC	Vanilla / Classic Era
1	LE_EXPANSION_BURNING_CRUSADE	The Burning Crusade
2	LE_EXPANSION_WRATH_OF_THE_LICH_KING	Wrath of the Lich King
3	LE_EXPANSION_CATACLYSM	Cataclysm
4	LE_EXPANSION_MISTS_OF_PANDARIA	Mists of Pandaria
5	LE_EXPANSION_WARLORDS_OF_DRAENOR	Warlords of Draenor
6	LE_EXPANSION_LEGION	Legion
7	LE_EXPANSION_BATTLE_FOR_AZEROTH	Battle for Azeroth
8	LE_EXPANSION_SHADOWLANDS	Shadowlands
9	LE_EXPANSION_DRAGONFLIGHT	Dragonflight
10	LE_EXPANSION_11_0	The War Within

Details

• Trial/Starter accounts are automatically upgraded to the second to last expansion.
• Updated after UPDATE_EXPANSION_LEVEL fires.

Example

Before and after the Shadowlands global launch at November 23 2020 at 3:00 p.m. PST. Requires the player to have pre-ordered/purchased the expansion.

/dump GetExpansionLevel() -- 7 -> 8
/dump GetAccountExpansionLevel() -- 8
/dump GetServerExpansionLevel() -- 7 -> 8

This API is equivalent to

GetExpansionLevel() == min(GetAccountExpansionLevel(), GetServerExpansionLevel())

Patch changes

Patch 3.3.0 (2009-12-08): Added.