Hello there! We are conducting a survey to better understand the user experience in making a first edit. If you have ever made an edit on Gamepedia, please fill out the survey. Thank you!

API GetSpellLink

From Wowpedia
Jump to: navigation, search

Get chat-link for a spell.

link = GetSpellLink(spellId)
link = GetSpellLink(spellName[, spellRank])
link = GetSpellLink(spellNum, spellBook)



Integer - The global spell number, found on wowhead, WoWDB, or through COMBAT_LOG_EVENT.


(spellName[, spellRank])

String - The name of the spell (Rank may be specified, defaults to highest if omitted)
String - The rank of the spell "Rank 1" etc. You can use "" and still get a response of the highest rank known. (useful for things like GetSpellLink("Faerie Fire (Feral)") which would return nil unless you use GetSpellLink("Faerie Fire (Feral)", "")


(spellNum, spellBook)

Integer - Valid values are 1 through total number of spells in the spellbook on all pages and all tabs, ignoring empty slots.
String - BOOKTYPE_SPELL or BOOKTYPE_PET depending on whether you wish to query the player or pet spellbook.


String - A link to the spell
Integer - ID number of the Spell



  • This link does not contain any ranks, for instance if you request a link for fireball rank 10 it would look like: [Fireball]

If you wish to display rank use GetSpellInfo and output using the following code:

local name, rank = GetSpellInfo(SpellID);
DEFAULT_CHAT_FRAME:AddMessage("Spell: |Hspell:" .. SpellID .."|h|r|cff71d5ff[" .. name .. " " .. rank .. "]|r|h")
  • This function returns the actual link for the spell in your spell book (i.e. the link you get when shift-clicking that spell) if given a spell name with no rank even if you got the spell name from a lower level spellID (e.g. GetSpellLink((GetSpellInfo(7411))) will return the link for Grand Master Enchanting, if known, despite 7411 being the spellID for Apprentice Enchanting).