Automated updating of API pages at this location, to reflect patch changes, has ceased from 10.1.7 onwards.

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.