ElvUI is a full user interface replacement for World of Warcraft, which means it completely replaces the Blizzard default UI.
ElvUI is not a collection of multiple addons, like some people may believe.
You can customize every single part of your UI to your liking.
Its very popular which means many people use it and you can share your ideas and profiles with the community and friends.
Many community plugins allow you to customize even further by adding whole new functions and options.
Part 1: Downloading ElvUI
As you may have noticed, unlike other WoW addons ElvUI is not available on the known Twitch Client (Curseforge).
In order to get your ElvUI copy you need to head over to our website https://www.tukui.org/welcome.php
Once on the website, you have two options to download and update your ElvUI.
1.1 Manual download and installation
In order to manually download ElvUI you can either click the "Download ElvUI" button in the middle of the website, or click on "Addons" in the top navigation bar of the website, then click ElvUI and choose between "Download (Retail)" or "Download (Classic)" where retail means BfA / Shadowlands and classic means WoW: Classic.
1.2 Auto download and installation via the Tukui Client
The Tukui Client is a lightweight addon installer for all addons on tukui.org including the major addons ElvUI and Tukui, aswell as all community-made plugins for the two UI replacements like AddOnSkins, Shadow&Light, MerathilisUI, BenikUI, LuckyoneUI and many more.
You can download the latest version of the Tukui Client with the following link: https://www.tukui.org/download.php?client=win
Note: The Tukui Client is only available for Windows users at the moment, Mac users have to use the manual download method.
Part 2: Installing ElvUI
A step-by-step on how to install the ElvUI addon and/or plugins from tukui.org and the Tukui Client.
2.1 Manually installing ElvUI
If you would like to install ElvUI without the Tukui Client, then you can simply follow those steps in the correct order.
- Download the .zip file from https://www.tukui.org/welcome.php
- Rightclick the .zip file and hit "Extract" (Windows)
- Open the extracted folders and check their capitalization -> ElvUI & ElvUI_OptionsUI
- Move them to the correct WoW folder: Either retail or classic -> Interface -> AddOns
2.2 Installing ElvUI via the Tukui Client
If you would like to use the Tukui Client to download and install ElvUI and their community plugins, then please follow those steps.
- Download the Tukui Client from https://www.tukui.org/download.php?client=win
- Rightclick the .zip file and hit "Extract" (Windows)
- Run the Client Install.msi file and follow their steps
- Open the Tukui Client and login (if you dont have a tukui.org account you can register for free at https://www.tukui.org/login.php)
- Click on "Browse" in the top bar of the Tukui Client
- Click on "Install ElvUI" and wait for the client to finish the install (status can be checked in the bottom left)
Part 3: Getting started with the ElvUI ingame installer
The first time you login to the game after you installed ElvUI, you will get pop-up step-by-step installer for some important steps to set up ElvUI.
Make sure to follow the installer steps once on every character before you make your own changes to the UI or import someones or your own profile.
Note: Those steps are just the initial setup of the UI, you can always change your mind later and access all of them in the options.
3.1 Installer Steps
- Welcome: Just a little welcome text and information how to access the ElvUI options after the installer is complete.
- CVars: CVars are Blizzards console variables which are relevant to ElvUI in order to work properly, do not skip this!
- Chat: The initial setup of the ElvUI chat module and skin, do not skip this!
- Theme: The initial setup of your color-style of the UI, you can always change your mind later!
- UI Scale: The overall screen scale for elements of your screen. I recommend 0.71 for 1920x1080.
- Default layouts: The default layouts of ElvUI for different roles, you can customize after the installer.
- Auras (Debuffs and Buffs): The mode how your Buffs and Debuffs are displayed (Bars or Icons), you can change this later aswell.
- Installation Complete: Link to our support Discord and the "Finished" button which will reload your UI to finalize the process.
Part 4: The ElvUI options and modules
Here are some screenshots of the current ElvUI menu with and without additional plugins installed.
Your version number is always displayed in the top bar of the addon options menu.
The ElvUI logo in the top left is always colored in your current class color.
4.1 Modules explained
The ElvUI menu has a lot of options and it can be information overflow if you open the window the first time but most of the modules and their different options are pretty self-explaining and have a description if you mouseover them.
Here is an overview of all modules. In-depth informations later on.
Options for the UI Scale, Auto Repair, Interrupt Announce and cosmetic Top Panel and Bottom Panel for your screen.
Options for Alternative Power used for example in fights like Carapace and N'Zoth or in Visions of N'Zoth to display sanity.
Some more Blizzard UI Improvements like height and auto-hide for the Objective Frame and Chat Bubbles style.
In here you can fully customize your ActionBars, Stance Bar, Micro Bar and ExtraActionButton.
You will find options to change their size, their font, mouseover options, action paging and much more.
ElvUI offers your 10! ActionBars instead of just 6 like in Blizzards UI.
Those are the options for your Bank, Bag and Bag-Bar.
You can change almost every part of them, some examples: Size, Fonts, Colors, Auto-Sell grays and junk.
The ElvUI Bank and Bags have a search bar by default if you are looking for specific items!
Buffs and Debuffs:
This part is about the Buffs and Debuffs near the minimap, like in Blizzards default UI.
You will find a toggle to enable/disable them. You can change their size, set up how many should be displayed and you can also enable the option Masque Support to allow the addon Masque to handle their skin.
By default, ElvUI comes with two chat panels (left and right). In here you will find many options to customize them.
You can seperatly edit both windows and also hide one or both, change their size, fonts, etc.
The ElvUI CD text module is highly customizable in terms of colors, style, fonts, thresholds and much more.
Some players like to compare the module to the addon OmniCC, with more options.
DataBars means XP Bar, Reputation Bar, Honor Bar and Azerite Bar. You will find many options to customize them like text format, fill orientation and toggles like mouseover or "Hide At Max Level".
Those are the little information bars below your chat windows and you can customize them in here to display whatever you want.
For example FPS/MS, Durability, Bag slots, Gold and many many more cool information panels!
All options for MiniMap and the big WorldMap, you can also change the position and size of your MiniMap buttons in here!
NamePlates are the little bars above NPCs and other players.
In ElvUI you will have 4 different sections to customize them: Enemy NPC, Enemy Player, Friendly NPC, Friendly Player.
Style Filters options are also in here and you can enable/disable a additional Classbar to display for example Combo Points.
The Target indicator offers many options like top arrows, side arrows and border or background color glow.
Toggles to enable or disable the ElvUI style for all UI elements like the character frame, map, bags.
The options for the Talking Head Frame backdrop and scale are also in here.
Your mouseover tooltip window to display information as you hover over items or players/npcs.
You can anchor it to your mouse or to a fixed position on the screen and also set up a auto-hide during combat and much more!
Unitframes is the biggest module of them, in here you will find all options for your player and target frame aswell as the raidframes etc.
ElvUI seperates them into two categories: Individual Units such as player, target, pet, focus and Group Units such as party, raid, tank, assist, arena and boss frames.
Available Tags is what you use in ElvUI to customize your displayed text on different frames like the player frame.
This list is a full overview with descriptions of all tags you can use in any "Text Format" or "Custom Text" box while editing your UnitFrames or NamePlates.
Some examples: [name] displays the name. [power] displays mana, energy, rage, etc. [level] displays the level.
In here you can edit your Aura (Buffs/Debuffs) filters.
For example you can add spell IDs or names to a blacklist or whitelist if you want to hide or show those specific spells on a frame.
I will include a comprehensive guide for aura filters in the links at the end.
You are playing different speccs/roles and want to copy some specific elements over to your other profiles?
No problem, with the module control of ElvUI you can copy everything over to your other profiles with a few clicks.
A list of installed ElvUI plugins and their version number (green up-to-date) (red outdated)
Credits and important links to the changelog, website, discord and wiki.
This is the place where you can create new profiles, export other players profiles or import your own profile to share it or back it up.
There are some elements in ElvUI you will find quite often, here is an overview and explanation for them.
Text Format: You will find the text format in almost every section of UnitFrames and NamePlates.
This is the place where you can set up Tags to display certain information like name, level, health and power.
You can also write custom text in here or mix Tags with custom text. Sounds confusing, but its not. Here are some examples:
[name] | [level] would show Luckyone | 120 - You can also remove the | and just write [name] [level] to show Luckyone 120
[health:percent] | [health:current] would show 100% | 530k
Custom Texts: They are only available for UnitFrames and give you even more options for your Tags. They basically are work the same way as Text Format but with more options.
Custom Texts have seperate options for Fonts, Anchor Point and X-Offset, Y-Offset.
Offset: Many elements in ElvUI have options for X-Offset and Y-Offset. This is basically a horizontal (X) and vertical (Y) offset for your elements.
You can move them to the left by decreasing the number of X or move them to the right by increasing the number of X.
Same goes for the vertical offset, decreasing the number of Y will move the element down and increasing the number of Y will move it up.
Part 5: Modules in-depth
5.1 Bottom Panel
Toggle Anchors: Use this button or the command /moveui to move around certain elements on your screen.
Reset Anchors: Reset all frames to their original position, be careful.
Reposition Window: Reset the size and position of the ElvUI menu window.
Install: If you wish to re-run the ElvUI installer.
Toggle Tutorials: Enable/Disable tutorial pop-ups.
ElvUI Status: A small information panel with all important informations needed for support questions.
General: Options for your UI Scale which determines the size of elements on your screen.
The Thin Border Theme which is basically a one-pixel border theme for your UI (enabled by default).
Toggles for a cosmetic Top Panel and Bottom Panel if you like it.
You can also change the Language of your ElvUI options menu, independent from your client language.
Enable Auto Repair from your own money or your guildbank.
Announce Interrupts can tell your friends if you successfully interrupted a cast.
Media: You can change your Fonts, Font Size and Textures in here, a wow-client restart is required for font changes.
Alternative Power: Alternative power is used for example to display sanity during visions of nzoth and the last two boss fights in Ny'Alotha.
You will find all the options in here for width/height of the bar, font and text format.
BlizzUI Improvements: In here you can make changes to things like the quest objective tracker and chat bubbles.
Options for your Objective Tracker like height and auto hide in boss combat or arena fights.
Change the fonts of your character frame and edit the itemlevel display.
Change the size of your vehicle seat indicator and durability display.
General: Overall options that apply to all your bars, such as Font, Font Size, Font Color and toggles for Macro and Keybind text.
Player Bars: Options for all your 10! action bars, seperated in tabs from Bar 1 to Bar 10.
Pet Bar: Options for your pet bar used mostly by Hunters and Warlocks, but also Monks.
Stance Bar: The stance bar for Warrior stances and Druid shapeshifts, but also Rogue stealth.
Micro Bar: This is the small bar to access your character frame, spellbook, dungeon finder and much more.
Boss Button: Options for the ExtraActionButton like alpha (transparency) and scale.
Vehicle Exit: Exit button when you are inside a vehicle or want to request early stop on a flight-route.
General: The general options which apply to both bag and bank, if you mouseover the checkboxes you will get a description.
Size: Adjust the width and height for your bag and bank.
Colors: Set up colors for profession bags such as Leatherworking, Herbalism and Mining. Change the border color of quest items.
Bag Bar: Enable a small bar with all your bags, you can move it around if you toggle your anchors with /moveui.
Split: You can enable a bag split to have for example a spacing between your single bags.
Vendor Grays: Enable if you want ElvUI to automatically sell your gray and junk items if you talk to a vendor.
Bag Sorting: ElvUI has a sort bags button on top of your main bag, those are the options for it.
Search Syntax: Documentation how you can use the search bar on top of your main bag.
5.5 Buffs and Debuffs
General: Options to either enable or disable Buffs and Debuffs near your minimap.
You can set up a fade threshold in seconds if you want the icons to fade out back in.
You can show or hide the duration text and also change the text position.
The Statusbar will add a small colored bar at the bottom of each icon to show their remaining duration.
The Masque support allows the addon Masque to handle skinning of this element.
Buffs: Options for your Buffs near the minimap, such as size and number of Buffs displayed.
Debuffs: Options for your Debuffs near the minimap, such as size and number of Debuffs displayed.
General: Chat options which apply to both tabs (left and right).
Toggles to enable/disable URL Links or shorten the channel names from [2. Trade] to .
Toggles to enable/disable Emotion Icons and LFG Icons in the chat.
You will find some more tabs like Tab Selector, History, Fade Chat, Fonts, Alerts, Voice Chat, Chat Timestamps and Class Color Mentions.
The Tab Selector can change the color of your current selected chat tab and/or add arrows and other indicators to it.
The History tab can set up your chat history for specific channels and the amount of saved messages up to 500.
Fade Chat will fade your chat window out if there is no activity, you can set up a timer between 5 and 120 seconds.
Fonts options only for the tab names. The chat window font is set up like Blizzards, with a right-click on the tab name.
Alerts like a sound for whisper messages or custom keywords, seperated by commas.
Voice Chat options to change the voice chat icon color or completely hide it.
Panels: In here you can change the two chat panels seperately.
For example the Panel Height and Panel Width (can also enable Seperate Panel Sizes)
The backdrop color and transparency.
Custom textures for your chat windows (must be 256x128 and .tga format)
Position of your Chat Editbox (the box when you type messages).
5.7 Cooldown Text
The Cooldown Text options are seperated in different tabs for different modules: Global, Buffs and Debuffs, ActionBars, Bags, NamePlates and UnitFrames.
This means you can either set up a global text and/or color setup or do it for each module seperately!
Global: Global CD text options for text and color thresholds. Font options are available aswell.
Buffs and Debuffs: Changes will only apply to your Buffs and Debuffs near your MiniMap.
ActionBars: Changes will only apply to your ActionBars, Pet Bar and Stance Bar.
Bags: Changes will only apply to your bags and bank windows.
NamePlates: Changes will only apply to your Auras anchored to your NamePlates (bars above their head).
UnitFrames: Changes will only apply to your Individual Units and Group Units frames (examples: player, party, raid).
Font options aswell as width/height options are available for all of the following bars:
XP Bar: Your player experience bar options. You can hide the bar in combat, set the bar to show only on mouseover and completely hide the bar when you are at max level or in a vehicle.
Reputation Bar: Faction reputation bar options. You can hide the bar in combat, set the bar to show only on mouseover and completely hide the bar when you are at max level or in a vehicle.
Honor: Honor bar options (PvP). You can hide the bar in combat, set the bar to show only on mouseover and completely hide the bar when you are at max level or in a vehicle.
Azerite Bar: Options for your BfA azerite (Heart of Azeroth). You can hide the bar in combat, set the bar to show only on mouseover and completely hide the bar when you are at max level or in a vehicle.
General: Changes apply to all your DataTexts (left chat, right chat, minimap, custom) such as Fonts and block interaction while in combat.
Panels: In here you can edit your different panels. Left Chat, Right Chat and MiniMap. You can open the dropdowns for position 1, 2 and 3 to select what you want to display (1 is left, 2 is middle, 3 is right).
Friends: Those options only apply to the Friends DataText if you are using it, you can hide friends by application (example: hide online friends in Overwatch or Mobile Chat).
Custom Currency: If you want to track a specific currency in your DataTexts, you can search for the currency ID on Wowhead and add it here.
After you added the currency ID it will appear in the Panels dropdown where you select the displayed DataTexts.
Map: Options for the big WorldMap. You can toggle coordinates and change their position and offset (y/x axis). Smaller World Map can scale down the WorldMap window to a custom percentage value.
Note: Those options are per-character, they dont copy over if you share or copy the profile.
Minimap: Options for the MiniMap.
You can adjust the position of the Location Text and the scale.
You can automatically reset your MiniMap zoom after 1 - 15 seconds.
Options to change the position and size of Blizzards Minimap Buttons like Mail, LFG Queue and Calendar.
You will find sections like Health, Power, Name, Level, CastBar, Buffs, Debuffs in every tab like Enemy NPC, Enemy Player to fully customize every single pixel of your NamePlates.
You can also use the "Copy From" button in the top right to copy options from for example Friendly NPC to Friendly Player.
General: Options apply to all of your NamePlates.
You can setup if you want them to stack or overlap (Motion Type) and how big the gap between them should be (Overlap Vertical).
In the Visibility section you can choose which enemy or friendly units you want to see or hide.
You can color almost every single element and set a color for interruptible and non-interruptible casts in the Colors section.
Style Filters: Style Filters is what makes the ElvUI NamePlates really special and different from other NamePlate addons.
You can create unlimited custom functions based on "Trigger" and "Action".
Some examples given: I create a new style filter, give it a name and go to the Trigger section and select how the function should trigger
(by name, by mark, on cast, etc) and then in the Action tab I select what will happen if the trigger condition is true
(different health bar color, make them invisible, make them bigger, let them fade, etc).
Player: Your player NamePlate or better known as "Personal Resource Display" is the bar in the middle of the screen right under your player, you can enable/disable and edit it in here.
Target: Set up target indicators for example arrows left and right of your currently selected nameplate unit. You can also enable/disable and customize a additional ClassBar in here for combo points and other resources.
Friendly Player: Options for players of your faction. Elements are seperated by tabs like Health, Power, Cast Bar, Buffs, Debuffs, etc.
Enable the Name Only mode in their General tab to show just their name, instead of a health bar.
Friendly NPC: Options for NPCs. Elements are seperated by tabs like Health, Power, Cast Bar, Buffs, Debuffs, etc. Enable the Name Only mode in their General tab to show just their name, instead of a health bar.
Enemy Player: Options for players of the opposite faction. Elements are seperated by tabs like Health, Power, Cast Bar, Buffs, Debuffs, etc. Role Icons to indicate Healers and Tanks can make it easy to switch on them!
Enemy NPC: Options for mobs and bosses you can attack. Elements are seperated by tabs like Health, Power, Cast Bar, Buffs, Debuffs, etc.
Ace3: This toggle enables/disables the skin for all Ace3 elements (can affect other Ace3 addons like BigWigs, WeakAuras).
Blizzard: This toggle enables/disables the Blizzard part of the UI such as ESC - Interface.
CheckBox Skin: This toggle enables/disables the skin for the small yellow checkboxes you see in the screenshots here.
Clean Boss Button: This toggle will remove the art around the ExtraActionButton and make it a clean square button.
Parchment Remover: Parchment is for example in the background of your Spellbook and Questlog, this will remove the parchment.
Tooltip: This is your mouseover tooltip to display information about players, npcs and items.
Pretty self explaining toggles to enable/disable informations like Player Titles and Current Mount or their Realm.
Font options are also given.
Visibility: In the bottom left section "Visibility" you can disable your mouseover tooltip for certain elements like UnitFrames, in case you dont want to see a tooltip on them.
You can also set up a modifier key like CTRL, Shift and Alt to show the tooltip only while holding the modifier. Combat hide is also an option.
UnitFrames options are seperated in 3 different sections. General, Individual Units (example: Player, Target, Pet) and Group Units (example: Party, Raid, Arena, Boss)
General: General, Frame Glow, Colors, Disabled Blizzard Frames, RaidDebuff Indicator.
General covers options like your StatusBar Texture (Mana and class resources) and your global UnitFrame font.
Frame Glow has toggles to enable/disable target glow and mouseover glow and also their color for your UnitFrames.
Disabled Blizzard Frames checkboxes are all enabled by default. Enabled means the specific default Blizzard frame is hidden.
RaidDebuff Indicator is your global setting to handle the style, position and cd text for your hots and shields.
Individual Units: Player, Target, TargetTarget, TargetTargetTarget, Focus, FocusTarget, Pet, PetTarget.
Options to edit every element of the above mentioned frames. Edit everything like Health, Power, Castbar, Name in here.
Group Units: Party, Raid, Raid40, Raid Pet, Tank, Assist, Arena, Boss.
Options to edit every element of the above mentioned frames. Edit everything like Health, Power, Castbar, Name in here.
Raid by default is used to display group sizes from 6 to 25 players with Smart Raid Filter disabled.
Raid40 will show up once your group size is at 26 players or more.
Smart Raid Filter is an option in the General tab of UnitFrames which automatically switches your frames depending on the amount of players and will also hide for example your 5th and 6th group (Bench) while raiding Mythic.
Text Format & Custom Texts: You might wonder what the "Text Format" box is all about, since it is available in every single Name, Health, Power and Level tab for each frame.
Its basically the place where you CTRL+V paste your custom tags to display specific informations and format.
The Available Tags section is a full overview of all tags so you can CTRL+C copy them from there.
5.15 Available Tags
The Available Tags section of the menu is an overview of every single tag you can add to "Text Format" and "Custom Texts" boxes to display custom information around your NamePlates and UnitFrames in ElvUI.
The yellow text will tell you the function of the tag and the box below can be used to CTRL+C and CTRL+V copy-paste.
In here you can handle all your Aura Filters like the blacklist and the whitelist
You can also add or remove spells from your Buff Indicators to display Hots and Buffs on your party or raidframes.
How to understand and set up filters in-depth guide: https://www.tukui.org/forum/viewtopic.php?f=5&t=2
Filter types and their function:
5.17 Module Control
With the Module Control of ElvUI you can export or import specific settings between two existing profiles.
For example: Copy your UnitFrames from your DPS profile to your healing profile.
Or copy your Chat setup to your other profile.
A list of all your installed and enabled plugins.
Green color means up-to-date.
Red color means outdated.
Important links for the Forum, Ticket Tracker, Discord, Changelog and the Development Build.
Credits for developers and contributors.
Credits for supporters.
New: Type a name and create a new profile, run the installer afterwards.
Existing Profiles: Switch to one of your already existing profiles.
Enable spec profiles: ElvUI can switch your layout depending on your current spec.
Copy From: This will copy the settings of the selected profile to your current profile and override it.
Delete a Profile: This will delete the selected profile, after you confirmed the pop-up.
Share Current Profile: Share your profile with your target, if they have ElvUI enabled and accept the pop-up.
Share Filters: Share your aura filters with your target, if they have ElvUI enabled and accept the pop-up.
Export Profile: Export your profile (CTRL+C) for a pastebin or wago or text file.
Import Profile: Import a profile from a pastebin or wago (CTRL+V).
Part 6: Incompatible Addons
Some addons cant be used with ElvUI or require you to disable the specific ElvUI module first.
For more information please check the next two steps.
6.1 Can be used with disabled ElvUI module
The following addons/plugins can be used, but you have to disable the specific ElvUI module first, before you enable them:
- Prat: (disable Chat module)
- Chatter: (disable Chat module)
- TidyPlates: (disable NamePlates module)
- Aloft: (disable NamePlates module)
- Healers-Have-To-Die: (disable NamePlates module)
- Plater: (disable NamePlates module)
- Bartender4: (disable ActionBars module)
6.2 Can't be used at all or are integrated
The following addons/plugins are integrated to ElvUI and you should delete them:
Part 7: Screenshot Gallery
The default TANK/DPS layout of the ElvUI installer.
The default Healing layout of the ElvUI installer.
The default layout of the ElvUI_BenikUI plugin.
The default layout of the ElvUI_MerathilisUI plugin.
The default layout of the ElvUI_LuckyoneUI plugin.
Part 8: Chat commands
Here is a list of all important ingame chat commands you should know.
8.1 General chat commands
- /console scriptErrors 1 Show LUA errors to report them.
- /fstack List all frames under the cursor.
8.2 ElvUI chat commands
- /ec or /elvui Open the ElvUI options.
- /moveui Toggle anchors to move stuff around.
- /kb Toggle the keybind mode.
- /egrid Toggle a grid on your screen.
- /estatus Display ElvUI stats for support questions.
- /luaerror on Disables all addons but ElvUI and ElvUI Options to for quick debugging.
Part 9: Additional information and links
9.1 Specific Guides
- How to set up filters (in-depth) https://www.tukui.org/forum/viewtopic.php?f=5&t=2
- How to use custom tags and custom texts (in-depth) https://www.tukui.org/forum/viewtopic.php?f=9&t=6
- How to install (with screenshots) https://www.tukui.org/forum/viewtopic.php?f=20&t=10792
- How to add custom media (fonts, textures, sounds) https://www.tukui.org/forum/viewtopic.php?f=20&t=1
9.2 Plugin suggestions
- AddOnSkins https://www.tukui.org/addons.php?id=3
To skin your other addons in the ElvUI style.
- Shadow&Light https://www.tukui.org/addons.php?id=38
Adds new features to ElvUI (example: Armory Mode)
- ProjectAzilroka https://www.tukui.org/addons.php?id=79
Adds new features like a clean bar for all your minimap addon icons.
- LuckyoneUI https://www.tukui.org/addons.php?id=154
My personal layouts for ElvUI and addon settings for BigWigs, Details, etc.
- MerathilisUI https://www.tukui.org/addons.php?id=1
Additional features, styles and layouts - check their description.
- BenikUI https://www.tukui.org/addons.php?id=11
Additional features, styles and layouts - check their description.