WoW GearMenu addon Dragonflight/Wrath of the Lich King Classic 2023
wow addon GearMenu


Game Version: 2.5.4
Total Downloads: 171,022
Updated: Apr 24, 2022
Created: Oct 4, 2019
download GearMenuDownload
download GearMenu classic 1.14.3Download
for Classic
download GearMenu classic 1.14.3Download
for Classic BC
Earlier Versions

Earlier Versions

Name Size Uploaded Game Version Downloads release 135.87 KB Apr 24, 2022 2.5.4 3 download GearMenu releaseDownload release 135.83 KB Apr 24, 2022 1.14.3 14 download GearMenu releaseDownload release 135.83 KB Feb 18, 2022 1.14.2 1,061 download GearMenu releaseDownload release 135.87 KB Feb 3, 2022 2.5.3 6,143 download GearMenu releaseDownload release 135.82 KB Feb 2, 2022 1.14.1 708 download GearMenu releaseDownload release 135.82 KB Feb 2, 2022 1.14.1 48 download GearMenu releaseDownload release 128.66 KB Nov 10, 2021 1.14.1 2,704 download GearMenu releaseDownload release 128.67 KB Nov 10, 2021 1.14.1 47 download GearMenu releaseDownload release 128.71 KB Oct 27, 2021 2.5.2 14,994 download GearMenu releaseDownload release 128.67 KB Oct 27, 2021 1.14.0 366 download GearMenu releaseDownload release 128.50 KB Oct 23, 2021 1.14.0 258 download GearMenu releaseDownload release 128.54 KB Oct 23, 2021 2.5.2 3,914 download GearMenu releaseDownload release 128.46 KB Oct 22, 2021 1.14.0 74 download GearMenu releaseDownload release 128.50 KB Oct 22, 2021 2.5.2 559 download GearMenu releaseDownload release 128.49 KB Oct 22, 2021 2.5.2 134 download GearMenu releaseDownload release 128.44 KB Oct 22, 2021 1.14.0 36 download GearMenu releaseDownload release 122.12 KB Oct 8, 2021 1.14.0 280 download GearMenu releaseDownload release 122.07 KB Sep 4, 2021 2.5.2 23,626 download GearMenu releaseDownload release 122.00 KB May 23, 2021 2.5.1 70,692 download GearMenu releaseDownload release 121.94 KB May 23, 2021 1.13.7 1,151 download GearMenu releaseDownload release 122.01 KB May 17, 2021 2.5.1 6,202 download GearMenu releaseDownload release 121.94 KB May 17, 2021 1.13.7 4,519 download GearMenu releaseDownload release 121.36 KB May 17, 2021 1.13.7 470 download GearMenu releaseDownload release 120.90 KB May 15, 2021 1.13.7 1,620 download GearMenu releaseDownload release 87.49 KB Apr 24, 2021 1.13.7 4,714 download GearMenu releaseDownload release 87.46 KB Oct 3, 2020 1.13.4 9,351 download GearMenu releaseDownload release 87.33 KB Aug 27, 2020 1.13.4 4,591 download GearMenu releaseDownload
gearmenu-v1.3.0 release 85.16 KB Mar 16, 2020 1.13.4 9,263 download GearMenu gearmenu-v1.3.0 releaseDownload
gearmenu-v1.2.0 release 79.86 KB Dec 20, 2019 1.13.3 3,474 download GearMenu gearmenu-v1.2.0 releaseDownload


Share this:



GearMenu aims to help the player switching between items in and out of combat. When the player is in combat a combatqueue will take care of switching the item as soon as possible. It also allows you to define switching rules and keybinding slots.

What is GearMenu?

GearMenus goal is to help the player switching between items on certain slots. Often players have items such as engineering items that have a one time use followed by a long cooldown. After using them during a fight the player wants to switch back to a more useful item. While changing items during combat is not possible (with some exceptions such as weapons) GearMenu can help with switching them as soon as possible. When a player tries to switch an item during combat it will be put into the combatqueue and switched as soon as possible. If the player leaves combat for just a split second all the items in the combatqueue will be switched. For some classes this might be even easier because they can use spells such as rogue – vanish or hunter – feign death.

Supported slots:

  • Head/Helmet slot
  • Neck slot
  • Shoulder slot
  • Chest/Robe slot
  • Waist/Belt slot
  • Legs slot
  • Feet/Boots slot
  • Wrist/Bracers slot
  • Hands slot
  • First/Upper ring slot
  • Second/Upper ring slot
  • First/Upper trinket slot
  • Second/Lower trinket slot
  • Back/Cloak slot
  • Main-hand slot
  • Secondary-hand/Off-hand slot
  • Ranged slot
  • Ammo slot



Burning Crusade Classic



Burning Crusade Classic

Features of GearMenu

Item switch for certain slots

With GearMenu it is easy to switch between items in supported slots. This is especially useful for engineering items that you wear for a certain amount of time and then switch back to your usual gear.


Certain items cannot be switched while the player is in combat. Weapons will be switched immediately whether the player is in combat or not. Other items that cannot be switched in combat will be enqueued in the combatqueue and switched as soon as possible. This is especially useful in PvP when you leave combat for a short time.

Note: You can right click any slot to clear the combatqueue for that slot

GearMenu also detects whether an itemswitch is possible even when out of combat. If you’re switching an item while you’re casting your mount or any other spell it will put the item in the combatqueue. As soon as the cast is over the item will be switched.

This is also the case if you cancel your cast.

Quick Change

Quick change consists of rules that apply when certain items are used. The player can define rules for items that have a usable effect. An item might be immediately switched after use or only after a certain delay. Otherwise the same rules for item switching apply. This means that if the user is in combat it will be moved to the combat queue and if he is out of combat the item will be immediately switched. See the optionsmenu for defining new rules based on the item type.

Note: If an item has a buff effect and you immediately change the item you will usually also lose its buff. In most cases it makes sense to set the delay to the duration of the buff


GearMenu allows to keybind to every slot with a keybinding. Instead of having a keybind for every item that you have to remember you set it directly on the slot itself.

Drag and drop support

GearMenu allows to drag and drop items onto slots, remove from slots and slots can even be switched in between.

Drag and drop between slots

Drag and drop item to GearMenu

Unequip item by drag and drop

Combined Equipping

Slots such as trinket and ring slots have combined equipping enabled. This means that in addition to a left click on the item the player wishes to equip they also support right click. Slots that do not support combined quipping (which most don’t) will normally equip any item whether it was left- or right-clicked. If the slot has combined equipping enabled a right click will instead put the chosen item into the opposite slot.

Unequip Items

Enable an empty slot in the changeMenu that allows for quicker and easier unequipping of items.


TrinketMenu allows the player to have all available trinkets and their status in view at all times. This makes it easier for the player to plan when to equip a trinket with a long cooldown. A left click will equip the trinket into the upper trinketslot and a right click will equip the item into the lower trinketslot.

Macro Support

If you prefer having certain items in your actionslots GearMenu can still be of use. By using the macro-bridge you get all the advantages of the combatQueue in a normal macro.

Add Item to CombatQueue

/run GM_AddToCombatQueue(itemId, slotId)

Note: It is not recommended to use this for weapons because addons cannot switch weapons during combat (GearMenu will put the item into the combatQueue). With a normal weaponswitch macro however this is still possible.

Clear Slot From CombatQueue

/run GM_RemoveFromCombatQueue(slotId)

Finding itemId

Finding the id of a certain item is easiest with websites such as wowhead.

Finding slotId

For finding the correct slotId refer to the image below. Only InventorySlotIds are valid targets for GearMenu


GearMenu is configurable. Don’t need a certain slot? You can hide it.

To show the configuration screen use /rggm opt while ingame and /rggm info for an overview of options or check the standard blizzard addon options.

Creating a GearBar

With the latest release it is possible to create multiple GearBars that can act independently of eachother.

Configure a GearBar

Each GearBar has some configurations that can be done individually for each GearBar. This includes various sizes of the GearBar, its locked or unlocked state and what GearSlots are configured for the GearBar.

Individual GearBar Configuration

Hide/Show Cooldowns

Whether cooldowns should be shown or hidden can be configured individually for each GearBar.

Hide/Show Keybindings

Whether keybindings should be shown or hidden can be configured individually for each GearBar.

Lock/Unlock Window

Whether a GearBar should be freely movable or be locked in place can be configured individually for each GearBar.

GearSlot Size

Every GearBar can have a different size for its GearSlots. You could for an example have a GearBar with very big trinkets and another with smaller slots for less important items.

ChangeMenu Size

The size of the ChangeMenu can be configured individual from the GearSlot size.

General Configuration

FastPress Support

Enable whether an item in a Gearslot should be used when the player pressed down(keydown) or only after the key was released(keyup).

Filter Items by Quality

Not interested to see items with a quality level below a certain level? Filter them out and only items that meet your set level will be considered to be displayed in GearMenu.


GearMenu supports two different themes for its ui elements. By default the custom theme will be used.



TrinketMenu Configuration

TrinketMenu supports the following configuration features.

  • Enabling/Disabling TrinketMenu completely
  • Lock/Unlock the TrinketMenu
  • Show or Hide trinket cooldowns
  • Adapt size of the TrinketMenu


The Addon is not showing up in WoW. What can I do?

Make sure to recheck the installation part of this Readme and check that the Addon is placed inside [WoW-installation-directory]\Interface\AddOns and is correctly named as GearMenu.

I get a red error (Lua Error) on my screen. What is this?

This is what we call a Lua error and it usually happens because of an oversight or error by the developer (in this case me). Take a screenshot off the error and create a Github Issue with it and I will see if I can resolve it. It also helps if you can add any additional information of what you we’re doing at the time and what other addons you have active. Also if you are able to reproduce the error make sure to check if it still happens if you disable all others addons.

A certain item is not showing up when I hover a slot. Why is that?

GearMenu filters by default, items that are below common (green) quality. This can be changed in the addon configuration settings in the option “Filter Item Quality”.

GearMenu failed to switch my item. What happened?

There are certain limitations that make it harder to switch an item even if the player is out of combat. One such example is that WoW prevents switching items while the player is casting a spell. GearMenu detects this and changes the item as soon as there is a pause between two spells or if a spell was cancelled. Just keep this in mind if you absolutely need the item switch to happen as soon as possible. Another factor can be a loss of control effect such as sap, iceblock and similar effects. In such circumstances it is not possible to switch an item. GearMenu is aware of such effects on the player and will switch the item as soon as possible.

If you still think you found an issue where GearMenu doesn’t switch items as expected feel free to create an issue in the respective repository.

Why can’t I switch Weapons during Combat?

This is a limitation that Blizzard puts on addons. It is not currently possible to switch to an arbitrary weapon while in combat. It is however possible to create weaponswitch macros because it is already known from which weapon to what weapon the player wants to switch. While it is not ideal, to workaround this issue GearMenu puts weapons in the CombatQueue if a weaponswitch is done while the player is in combat. If he is not in combat the switch will happen immediately. This might be improved in a future release if there is a better workaround possible.

Note: It is also possible to switch a weapon by drag an dropping the weapon in the standard Blizzard interfaces. This however is in no way connected to GearMenu

Why can’t I create an Itemset?

This addon does not have the intention on supporting the functionality of switching between a PVE and a PVP set (or any other set). Its intention is to assist the player in switching single items fast and possibly during combat. It does not try to be the next Outfitter addon.


Add a comment