Troubleshooting Addons

Addon problems look like game problems: broken buttons, missing frames, errors on login, weird behavior mid-fight. The fix is almost always the same short process.

The order that works

• Update everything first. Most addon breakage is a game patch outrunning an old version — your addon manager updates them all at once.
• Fully restart the game after updating; reloading the UI is not always enough after a patch.
• If it persists, disable ALL addons and confirm the problem is addon-related at all.

Find the culprit

Re-enable addons in halves: turn on half, test, narrow down. With a dozen addons this takes three or four rounds. The addon that breaks when enabled — or fixes things when disabled — is your answer. Check its settings or known issues before assuming the addon is simply broken.

Common non-obvious causes

• Two addons doing the same job — two bag addons or two unit-frame replacements will fight each other.
• An addon profile from another character or a corrupted saved setting — resetting that addon's profile often fixes 'random' weirdness.
• Errors that appear only in combat: some addons break under specific conditions; note exactly when it happens.

Stuck on something here? Post a note on the Academy Learning Board — someone aboard has been exactly where you are.