IsItemInRange

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

	C_Item.IsItemInRange		+ 10.2.6
	IsItemInRange		+ 2.0.1 / 1.13.2

Returns whether the item is in usable range of the unit.

inRange = IsItemInRange(item [, unit])

Arguments

item

number|string : Item ID, Link or Name - If using an item name, requires the item to be in your inventory. Item IDs and links don't have this requirement.

unit

string? : UnitId - Defaults to "target"

Returns

inRange

boolean - Whether the item is in range; Returns nil if there is no unit targeted or the item ID is invalid.

Example

Prints if you are within 4 yards range of the target by checking the  [Gin-Ji Knife Set] item range.

/dump IsItemInRange(90175)

Patch changes

Hotfix (2023-12-11): Partially unrestricted. Querying enemy units while in combat is once again permitted. (Build: 10.2.0.52485)
Hotfix (2023-11-16): Protected. May no longer be called in combat by insecure code. (Build: 10.2.0.52188)
Patch 2.0.1 (2006-12-05): Added.