How to Update ElvUI Without Losing Settings

How to update ElvUI safely after a release check

Compare the installed version with Tukui and match the supported interface number to the WoW client you actually launch. The August 22, 2026 check found ElvUI 15.24 and Retail interface 12.1.0; a later client patch can change that relationship.

Do not update only one core directory. ElvUI, ElvUI_Libraries and ElvUI_Options are one release unit, and a clean replacement is easier to troubleshoot than merging new files over an old folder.

Update ElvUI step by step without deleting settings

1. 1

   Back up WTF

   Close WoW and copy the WTF folder for the exact Retail or Classic branch you are changing. Export important profiles from /ec as an additional backup.

2. 2

   Remove old addon code

   Delete ElvUI, ElvUI_Libraries and ElvUI_Options from Interface/AddOns. Do not delete WTF for a routine update.

3. 3

   Copy the replacement folders

   Extract the current archive, open any outer wrapper and place all three fresh folders directly in the active AddOns directory.

4. 4

   Launch and verify

   Check the displayed version at character select, test base ElvUI, then re-enable optional plugins one at a time.

Fix an ElvUI update that still shows the old version

If the old version remains, check whether Battle.net launched a different client directory, whether an outer archive wrapper was left in place, or whether WoW was still open during replacement. Confirm that each TOC file is directly under its addon folder.

If Lua errors appear, disable optional extensions and test a new profile before touching WTF. Restore a backup only after preserving any new changes that matter; use the profiles guide when the problem is limited to imported settings.

How to update ElvUI safely after a release check

The first step in how to update ElvUI safely is checking whether an update actually exists. Compare the installed addon version shown at character selection or in ElvUI with the release displayed by Tukui. Also compare the supported interface number with the WoW client being launched. At the August 19, 2026 verification, Tukui reported ElvUI 15.24, updated August 19, with several live client interfaces. A future visitor should use a newer Tukui release if one has replaced that version.

Knowing how to update ElvUI safely also means choosing the right time: after a major WoW patch, when Tukui publishes compatibility fixes, when ElvUI reports an available version or when a reproducible base-addon error is fixed by a newer release. Do not update only one of the three core directories. ElvUI, ElvUI_Libraries and ElvUI_Options are one release unit and should always be replaced together.

The process for how to update ElvUI safely uses Tukui or a matching public Git tag. Avoid updater executables and mirrors that cannot demonstrate provenance. Keep the new archive and the previous working archive until the updated installation has completed a full login, reload and restart without repeated errors.

Back up profiles before you update ElvUI

ElvUI profiles and saved variables live under the World of Warcraft WTF directory, not inside the three addon code folders. A routine update therefore should not erase profiles, but a backup protects against deleting the wrong directory, saved-variable migration problems and unrelated addon corruption. Close WoW, copy the WTF directory to a dated backup location and verify that the copy completed before changing Interface/AddOns.

For important layouts, open /ec, select Profiles and export the profile string as an additional portable record. Note the ElvUI version, screen resolution, UI scale and required plugins beside the export. The string does not include every WeakAura, SharedMedia font or third-party addon, so a complete recovery still benefits from the WTF backup and a written dependency list.

Players with Retail and Classic installed should back up the branch they are changing and confirm the selected Battle.net client. The folders can sit beside each other and contain profiles with similar names. A careful branch check prevents an update from being applied to the wrong installation while the intended client remains outdated.

Replace ElvUI folders instead of merging an update

Exit WoW completely. Open the active client's Interface/AddOns directory and delete ElvUI, ElvUI_Libraries and ElvUI_Options. Do not delete WTF. Extract the new archive, open any outer wrapper and copy the three fresh core directories into AddOns. This clean replacement is the recommended practical answer to how to update ElvUI because it removes files that the new release may have renamed or retired.

Merging a new archive over an old installation can leave stale Lua files. Those files may load even though they are absent from the current release, producing errors that appear to be new-version defects. A clean replacement also prevents the main directory, libraries and options module from ending on different versions. Verify the directory depth and confirm that each TOC file is directly under its core addon folder.

Start WoW, open AddOns and confirm the displayed version. Enter the world and allow any saved-variable migration to complete. Test base ElvUI before updating optional plugins. Companion projects may require their own updates and can produce errors even when the core replacement is correct.

Troubleshoot an ElvUI update without deleting settings

If WoW still reports the old version, the most likely causes are updating a different client directory, leaving an outer archive wrapper or keeping the game open during file replacement. Reopen the selected Battle.net install location and compare it with the edited path. Confirm that the AddOns list points to all three fresh directories and that no duplicate ElvUI copy exists under another nested folder.

If Lua errors begin after updating, disable every optional ElvUI extension and test a new temporary profile. When base ElvUI works, update and re-enable extensions one at a time. When the options panel is missing, inspect ElvUI_Options and ElvUI_Libraries. When the whole addon is absent, inspect directory depth. Do not delete WTF as the first troubleshooting step because that resets many addons and destroys useful evidence.

Restore the backup only after preserving any new changes that matter. If an older core release is needed for diagnosis, install a verified tag cleanly and use a copied profile. Return to the supported current version when testing ends. The safest method for how to update ElvUI is repeatable: verify, back up, replace three folders, test base ElvUI, then restore optional components.