WoW API < UIParentLoadAddOn

Load or reload an addon.

loaded = UIParentLoadAddOn( index or "addonName" );

Parameters[edit | edit source]

Arguments[edit | edit source]

(index or "addonName")
Integer - The index of the AddOn in the user's AddOn list. Note that you cannot access Blizzard-provided AddOns through this mechanism.
String - The name of the addon you want to load or reload.

Returns[edit | edit source]

Flag - Indicates if the AddOn was loaded, 1 if it is, nil if it is not.
An error message is issued if the addon failed to load.

Example[edit | edit source]

local loaded = UIParentLoadAddOn( "MyFunkyAddon" );

Result[edit | edit source]

loaded = 1 or nil

Details[edit | edit source]

  • If the addon fails to load, it is added to a list of failed addons. If you try to load the addon again without reloading the UI, you will not be notified of failure unless you use LoadAddOn and write your own edge case.
  • As of patch 1.8, you can only use this for addons that are marked on demand in their .toc files (## LoadOnDemand: 1).

Functionally similar to this:

local loaded, reason = LoadAddOn(name);
if ( not loaded ) then
    message(format(ADDON_LOAD_FAILED, name, getglobal("ADDON_"..reason)));
Community content is available under CC-BY-SA unless otherwise noted.