Equips an item, optionally into a specified slot.

EquipItemByName(itemId or "itemName" or "itemLink"[, slot])

Parameters Edit

Arguments Edit

(itemId or "itemName" or "itemLink"[, slot])

itemId 

Integer - The numeric ID of the item. ie. 12345

itemName 

String - The name of the item, ie "Worn Dagger". Partial names are valid inputs as well, ie "Worn". If several items with same piece of name exists, the first one found will be equipped.

itemLink 

String - The itemLink, when Shift-Clicking items.

slot 

Numeric - (optional) - The inventory slot to put the item in, obtained via GetInventorySlotInfo().

Changes in 3.3.0 Edit

When in combat this function now "picks up" the item instead of equipping it, similar to PickupInventoryItem. Out of combat, the function behaves as expected. This change was made to address the issue of rogues using "poison swapping" addons to increase their DPS.^[1]

References Edit