How to Install ElvUI: A Complete Setup Guide for World of Warcraft

ElvUI is one of the most popular UI replacement addons for World of Warcraft — and for good reason. It replaces nearly every default interface element with a cleaner, more customizable alternative. But because it's not hosted on CurseForge like most addons, the installation process trips up a lot of players. Here's exactly how it works.

What Is ElvUI and Why Isn't It on CurseForge?

ElvUI is a complete UI overhaul, not a single addon. It replaces your action bars, unit frames, minimap, chat windows, buff tracking, and more — all from one package. The developers at Tukui maintain it independently, which means it lives on Tukui.org, not on CurseForge or Wowhead's addon library.

This is the single most common source of confusion. Players search for ElvUI in the Curseforge app, don't find it, and assume something is wrong. Nothing is wrong — you just need to go to the right place.

Method 1: Manual Installation (Always Works)

This method works regardless of what addon manager you use or don't use.

Step 1 — Download the files

Go to tukui.org and navigate to the ElvUI download page. You'll see two separate packages:

• ElvUI — the core addon (required)
• ElvUI_OptionsUI — the configuration interface (also required for in-game settings)

Download both. They come as .zip files.

Step 2 — Locate your WoW AddOns folder

The default path depends on your operating system:

If you installed WoW in a custom location, navigate there instead. The _retail_ folder is for the current live version of WoW. For Classic versions, look for _classic_ or _classic_era_ depending on which version you play.

Step 3 — Extract and place the folders

Unzip both downloaded files. You should end up with two folders:

• ElvUI
• ElvUI_OptionsUI

Drag both folders directly into your AddOns directory. Don't place them inside a subfolder — they need to sit at the top level of the AddOns folder.

Step 4 — Launch or restart WoW

If the game is already running, close it fully and relaunch. At the character selection screen, click AddOns in the bottom-left corner and confirm that both ElvUI entries appear and are enabled.

Step 5 — Run the setup wizard

The first time you log in with ElvUI active, a setup wizard will appear automatically. This walks you through basic configuration — UI scale, layout style, role-specific settings, and more. You can re-run it later via /ec (ElvUI Config) in the chat window.

Method 2: Using the Tukui Client

Tukui offers its own lightweight addon manager that handles ElvUI installation and updates automatically.

1. Download the Tukui Client from tukui.org
2. Install and open the client
3. Point it to your WoW installation directory
4. Select ElvUI from the addon list and click install

The Tukui Client checks for updates each time you open it, which is useful since ElvUI updates frequently — especially after major WoW patches. 🔄

Method 3: Using CurseForge or Overwolf (With a Workaround)

CurseForge doesn't officially host ElvUI, but some users add a custom repository URL pointing to Tukui's API within certain addon managers. This approach works but may not always stay current with ElvUI's latest releases. If you rely on CurseForge for everything else, it's worth investigating whether your specific client version supports custom repositories — results vary.

Common Installation Problems

ElvUI doesn't appear in the AddOns list The folders are probably nested incorrectly. Open the AddOns folder and confirm you see ElvUI as a folder name directly inside AddOns — not ElvUI-main or a folder inside another folder.

"Out of date" warning at the AddOns screen Click "Load out of date AddOns" as a temporary fix. Then update ElvUI through Tukui.org or the Tukui Client. This happens when WoW patches faster than the addon updates, which is common in the days immediately after a major patch.

Setup wizard didn't appear Type /elvui or /ec in chat to open the configuration panel manually. From there you can access all settings and reset the installation wizard if needed.

UI looks broken or overlapping Run /ec and explore the General section. UI Scale is usually the culprit — ElvUI sets its own scale independently of WoW's system settings. Adjusting it resolves most layout issues. 🖥️

What Happens After Installation

ElvUI essentially replaces the default WoW interface at a deep level. Many players then layer additional addons on top — things like WeakAuras, Details! Damage Meter, or Deadly Boss Mods — which all coexist with ElvUI without conflict in most cases.

The addon also has a robust profile system, meaning you can save your layout configuration and share it with others, or import profiles that other players have shared publicly. Profile strings are a common way for guilds or content creators to distribute their exact UI setups.

The Variables That Affect Your Experience

How ElvUI looks and performs after installation depends on several factors specific to your situation:

• WoW version — Retail, Classic Era, and Wrath Classic each have separate ElvUI builds. Installing the wrong version won't work.
• Screen resolution and aspect ratio — ElvUI's default layout is designed around standard widescreen ratios. Ultrawide or non-standard displays need manual adjustment.
• Other addons already installed — Some addons also try to control unit frames or action bars, which can create conflicts. Knowing which addons you already run matters.
• Role and playstyle — A healer's ideal layout looks very different from a tank's or a DPS player's, and ElvUI's setup wizard accounts for this — but the defaults won't suit everyone equally. 🎮

The installation itself is straightforward once you know ElvUI lives outside the standard addon ecosystem. Where players diverge is in how they configure and build on top of it — and that configuration is entirely shaped by how you actually play the game.