DisableAddOn

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

	C_AddOns.DisableAddOn		+ 10.2.0 / 1.15.0
	DisableAddOn		+ 1.7.0 / 1.13.2

Disables an addon for subsequent sessions.

DisableAddOn(addon [, character])

Arguments

addon

number - addonIndex from 1 to GetNumAddOns()

or string - addonName (as in toc/folder filename) of the addon, case insensitive.

character

string? - playerName of the character (without realm)

or boolean? - enableAll True if the addon should be enabled/disabled for all characters on the realm.

Defaults to the current character. This param is currently bugged when attempting to use it (Issue #156).

Details

• Takes effect only after reloading the UI.
• Attempting to disable secure addons with the GuardedAddOn TOC metadata field will result in an "Cannot disable a guarded AddOn" error.

Example

• Enables the addon at index 1 for the current character.

function PrintAddonInfo(idx)
	local name = GetAddOnInfo(idx)
	local enabledState = GetAddOnEnableState(nil, idx)
	print(name, enabledState)
end

PrintAddonInfo(1) -- "HelloWorld", 0
EnableAddOn(1)
PrintAddonInfo(1) -- "HelloWorld", 2

• This should enable an addon for all characters, provided it isn't bugged.

EnableAddOn("HelloWorld", true)

• Blizzard addons can be only accessed by name instead of index.

DisableAddOn("Blizzard_CombatLog")

Patch changes

• Patch 10.1.0 (2023-05-02): Secure addons with the GuardedAddOn TOC metadata field can no longer be disabled.