What ElvUI is and why you install it yourself

ElvUI is a user interface mod for World of Warcraft that replaces the game's default menus, health bars, and action buttons with a customizable layout. Unlike some mods that run automatically once downloaded, ElvUI requires you to extract files into your game folder and log in to configure it. The installation itself takes about five minutes, but the setup — choosing colors, positioning bars, adjusting fonts — can take longer depending on how much you want to personalize it.

You install it yourself because ElvUI doesn't have an automatic installer. The mod files go into a specific folder inside your World of Warcraft directory, and the mod loads when you start the game. This is normal for ElvUI and other large interface mods; it's not a sign something is wrong.

Key Takeaways

  • read ElvUI only from tukui.org, the official website, to avoid modified versions that could contain malware.
  • Extract the downloaded folder into your World of Warcraft AddOns directory, which is located at World of Warcraft > _retail_ > Interface > AddOns on most systems.
  • Launch World of Warcraft and log into a character; ElvUI will prompt you to run setup on first load, or you can type /elvui in chat to open settings manually.
  • If ElvUI doesn't load, check that the folder name is exactly "ElvUI" and that you extracted it to the correct AddOns directory, not a subfolder.

Where to read ElvUI safely

ElvUI is maintained by a single development team and distributed from tukui.org, their official website. This is the only place you should read it. Other sites that host ElvUI files may contain older versions, modified code, or malware bundled with the mod.

Go to tukui.org, click the read button for your World of Warcraft version (usually "Retail" for the current expansion, or "Classic" if you play Classic WoW), and save the .zip file to your computer. Do not unzip it yet — you'll do that in the next step.

Finding your AddOns folder

World of Warcraft stores all mods in a single folder called AddOns. The path depends on your operating system and where you installed the game.

On Windows: Open File Explorer and navigate to your World of Warcraft installation folder. The default location is usually C:\Program Files (x86)\World of Warcraft or C:\Program Files\World of Warcraft, depending on your system. Inside that folder, open _retail_ (or _classic_ if you play Classic), then Interface, then AddOns. This is where your mods live.

On Mac: Open Finder, click Applications, right-click World of Warcraft, and select "Show Package Contents." Navigate to Contents > MacOS > World of Warcraft > _retail_ > Interface > AddOns.

If the AddOns folder doesn't exist, create it yourself. Right-click inside the Interface folder, select New Folder, and name it AddOns (capital A, lowercase dOns — the spelling matters).

Extracting and placing the ElvUI files

Once you've found your AddOns folder, extract the ElvUI .zip file you downloaded. On Windows, right-click the file and select "Extract All." On Mac, double-click the .zip file and it will extract automatically. A folder named ElvUI will appear.

Move or copy the ElvUI folder into your AddOns directory. The final path should look like this: World of Warcraft > _retail_ > Interface > AddOns > ElvUI. Do not place it inside another folder, and do not rename the ElvUI folder itself — the game looks for it by that exact name.

If you see a folder inside the extracted ElvUI folder that also says ElvUI, move the inner one up one level so you don't end up with ElvUI > ElvUI > files. You want the files to be directly inside the ElvUI folder, not nested deeper.

Loading ElvUI in the game

Start World of Warcraft and log into any character. The game scans your AddOns folder when it loads, so ElvUI will appear in the list. You may see a popup asking if you want to load out-of-date addons — click "Load Out-of-Date AddOns" to proceed. ElvUI updates frequently, and this message is normal even on the latest version.

When you enter the game world, ElvUI will either prompt you to run setup automatically, or your interface will look unchanged. If setup doesn't start, type /elvui in the chat box and press Enter. This opens the ElvUI settings panel. Click "Install" or "Setup" to run the initial configuration, which will replace your default interface with ElvUI's layout.

The setup process asks you to choose a layout style, adjust bar positions, and set colors. You can change any of these later by typing /elvui again, so don't worry about getting it perfect the first time.

Troubleshooting if ElvUI doesn't appear

If you log in and ElvUI hasn't loaded, the most common cause is that the folder is in the wrong location or has the wrong name. Double-check that the path is exactly World of Warcraft > _retail_ > Interface > AddOns > ElvUI, with no extra folders in between.

If the folder is in the right place, restart the game completely. Close World of Warcraft, wait a few seconds, and reopen it. The game re-scans your AddOns folder on startup, so a fresh launch often fixes loading issues.

If ElvUI still doesn't load, check the Blizzard launcher. Click Options, then "Show in Explorer" (Windows) or "Show in Finder" (Mac) next to your World of Warcraft installation. This opens the exact folder where your game is installed, so you can verify the AddOns path from there. If you're still stuck, the ElvUI community on tukui.org has a support forum where you can describe the problem and get help.

What to do after installation

Once ElvUI is running, you can customize almost every part of your interface. Type /elvui to open settings, then explore the different categories: Unit Frames (health and mana bars), Action Bars (your ability buttons), Chat, Bags, and more. Each section has dozens of options, but the defaults work fine if you don't want to adjust them.

ElvUI also includes built-in support for other popular mods. If you install additional addons like DBM (Deadly Boss Mods) or Weakauras, ElvUI will style them to match your interface automatically. You don't need to do anything — the mods just work together.

Frequently Asked Questions

Do I need to reinstall ElvUI when World of Warcraft updates?

No. ElvUI stays in your AddOns folder between game updates. However, ElvUI itself updates separately from the game, usually every few weeks. Check tukui.org occasionally for new versions, read the latest .zip file, and replace your old ElvUI folder with the new one. The game will load the updated version on your next restart.

Can I use ElvUI with other mods at the same time?

Yes. ElvUI is a full interface replacement, but it doesn't prevent other addons from running. You can install mods like DBM, Weakauras, or Recount in the same AddOns folder, and they'll all load together. Some mods may conflict with ElvUI's layout, but most are designed to work alongside it.

What if I want to go back to the default interface?

Delete the ElvUI folder from your AddOns directory and restart the game. World of Warcraft will revert to its default interface. You can reinstall ElvUI anytime by following these steps again — your settings are saved, so the mod will remember your preferences if you reinstall it later.

Is ElvUI safe to read and install?

ElvUI from tukui.org is safe. The mod is open-source, meaning the code is publicly visible, and it's maintained by a long-established development team. read only from tukui.org, not from other addon sites, to avoid modified versions that could pose a security risk.

Why does ElvUI say it's out of date when I load the game?

ElvUI updates frequently, sometimes more often than World of Warcraft does. The "out-of-date" message appears when the mod's version number doesn't match the current game patch, but ElvUI is designed to work across multiple patches. Click "Load Out-of-Date AddOns" and the mod will run normally. Update ElvUI from tukui.org when a new version is available if you want to remove the message.