How to Write a Mouseover Healing Macro in WoW Retail
Create a keyboard macro that heals a friendly mouseover, with optional fallbacks for your target or yourself.
Art: Blizzard EntertainmentA mouseover healing macro in World of Warcraft Retail lets you keep your current target while casting a heal on the friendly player under your pointer. Put the macro on a keyboard binding, hover a party member's frame, and press the key. Start with a version that only casts on a valid mouseover. Add fallback targets after you've decided what should happen when your cursor slips.
Create a macro that only heals your mouseover
- Type
/macroand create a character-specific macro. Give it a name you can recognize among your healing buttons. - Paste the example below. Replace Flash Heal with the exact name of a friendly heal in your Spellbook if you're playing a different class or using a localized client.
- Drag the macro onto an action bar and assign a keyboard binding to the slot.
- Join a friend in a safe area. Select a different target, put the pointer over your friend's party frame, and press the key. Check that your friend received the heal and your selected target stayed the same.
#showtooltip Flash Heal
/cast [@mouseover,help,nodead] Flash Heal
The first line displays the spell's tooltip. The second tells the game to try the spell on the unit under your pointer if the unit is friendly and alive. With no matching mouseover, this version does nothing. That makes it a good choice for a healer who wants a misplaced cursor to result in no cast rather than spending mana on an unintended target.
Choose a fallback only if you want one
If you prefer one key for your mouseover, your selected friendly target, and yourself, replace the cast line with this version:
/cast [@mouseover,help,nodead][help,nodead][@player] Flash Heal
The game reads the bracketed groups in order. It looks for a friendly living mouseover, then a friendly living selected target, then uses you. When the first group matches, that group supplies the target. Range and line of sight can still stop the cast. A living ally behind a wall can pass the conditions and still be out of reach. The macro doesn't detect the failed heal and retry the next group.
This behavior matters if you spend most of a fight targeting the enemy. With a fallback to yourself, a missed mouseover can cast on you even when you meant to heal the tank. Test both versions and decide whether silence or an emergency self-heal makes sense for that button. You can keep a separate self-heal on a different key if you want the strict version for group healing.
Test the binding against real movement
Run three checks with a friend. First, hover their frame while targeting an enemy or another unit. Next, move the pointer to empty space and try again. Finally, ask them to move out of range while you still hover their frame. For each test, check the target of the heal or the error the client reports. This separates a bad binding from a valid binding whose target is unavailable.
Repeat while moving between two frames. If you often land on the wrong player, enlarge or reposition the group frames before adding more spells. A mouseover macro can't choose the teammate with the lowest health. It depends on which unit is under the pointer when you press the key.
Fix a macro that heals the wrong unit
If you are healing yourself unexpectedly, read the brackets from left to right and check for [@player] or an empty fallback group. Try the strict version to isolate whether a fallback is responsible. Also check the built-in Mouseover Cast and self-cast settings if you already changed them while setting up healing.
If clicking the action bar works but pressing the key doesn't, check that the key is assigned to the macro's slot and isn't used by another binding. If the icon appears but the spell never casts, compare its name with the Spellbook and test on a nearby friendly player. A helpful condition won't match an enemy frame, and nodead excludes a dead ally.
Start with one heal and use it in an easy group. Once the target behavior is familiar, copy the pattern for another friendly spell whose targeting you can test separately.
Sources
This article was written by AI (Claude) and checked against the sources above. Games are updated regularly, so details may change.