Wow API Escape Sequences

WoW UI Escape Sequences

This skill documents the UI escape sequences available in World of Warcraft addon development. Many UI elements that display text on screen support special sequences starting with the | (pipe) character. These sequences enable inline coloring, texture/atlas rendering, grammar inflection, word-wrapping hints, and more — all within ordinary Lua strings.

Source of truth: https://warcraft.wiki.gg/wiki/UI_escape_sequences Current as of: Patch 12.0.0 (Retail only) Scope: All | escape sequences recognized by the WoW UI text renderer.

When to Use This Skill

Use this skill when you need to:

• Embed color codes in chat messages, tooltips, or FontStrings
• Use named global colors (|cn) or item-quality colors (|cnIQ)
• Insert inline textures or atlas icons into text
• Apply localized grammar rules (Korean, French, Russian, plurals, articles)
• Understand word-wrap hints (|W) or Kstring obfuscation (|K)
• Use helper functions like WrapTextInColorCode(), CreateTextureMarkup(), CreateSimpleTextureMarkup(), or CreateAtlasMarkup()

Relationship to Other Skills

Important: The Pipe Character

In Lua source code you can use | directly:

print("|cFFFF0000Red text|r normal")

In the chat window or in-game text editors, the literal | is escaped. Use \124 (the ASCII code for pipe) instead:

/run print("\124cFFFF0000Red text\124r normal")

Coloring

ARGB Hex Color

|cAARRGGBBtext|r

• AA — Alpha (currently ignored; always use FF).
• RR GG BB — Red, green, blue channels as two hex digits each.
• |r — Pops the most recent color, restoring the previous one (since Patch 9.0.1). Previously it reset to the default color entirely.

Nesting example:

print("white |cFFFF0000red |cFF00FF00green|r back to red|r back to white")

Global Named Colors (|cn)

|cnCOLOR_NAME:text|r

Renders text using a named GlobalColor. The color name comes from the GlobalColor database table.

print("|cnPURE_GREEN_COLOR:Green text|r normal")

Item Quality Colors (|cnIQ)

|cnIQn:text|r

Renders text using the color for item quality n, where n is a numeric Enum.ItemQuality value (0 = Poor/gray, 1 = Common/white, 2 = Uncommon/green, 3 = Rare/blue, 4 = Epic/purple, 5 = Legendary/orange, …). The color updates to match the user's color-override settings.

print("|cnIQ4:Epic quality text|r")

Added in Patch 11.1.5. Named colors (|cn) added in Patch 10.0.0.

Textures

Inline Texture

|Tpath:height[:width[:offsetX:offsetY[:textureWidth:textureHeight:leftTexel:rightTexel:topTexel:bottomTexel[:rVertexColor:gVertexColor:bVertexColor]]]]|t

Inserts an image into a FontString. path may be a file path (with / or \\ separators) or a numeric FileDataID.

Size Rules

Optional Parameters

Common Patterns

-- Square icon at text size (most common for spell/item icons)
"|T133784:0|t"
"|TInterface/Icons/INV_Misc_Coin_01:0|t"

-- Explicit 16×16 icon
"|TInterface/Icons/INV_Misc_Coin_01:16|t"

-- Rectangular image with aspect ratio
"|TInterface/Glues/LoadingBar/Loading-BarFill:0:2|t"

-- Cropped texture (4px border removed from a 64×64 source)
"|TInterface/Icons/INV_Misc_Coin_01:16:16:0:0:64:64:4:60:4:60|t"

-- Tinted texture (green tint: 73,177,73)
"|TInterface/ChatFrame/UI-ChatIcon-ArmoryChat:14:14:0:0:16:16:0:16:0:16:73:177:73|t"

Texture Atlas

|A:atlas:height:width[:offsetX:offsetY[:rVertexColor:gVertexColor:bVertexColor]]|a

Inserts a texture atlas region. The atlas may be a name string or a numeric atlas ID. Note the : after |A.

-- Atlas by name
"|A:groupfinder-icon-role-large-tank:19:19|a Tank"

-- Atlas by numeric ID
"|A:4259:19:19|a Tank"

See also: AtlasID

Kstrings

|Kq1|k

Kstrings are opaque string placeholders that prevent addon parsing of confidential or protected text. They are rendered by the client as the actual display string but cannot be read as plaintext by addons.

Added in Patch 4.0.1.

Grammar / Localization Sequences

These sequences handle language-specific inflection so that a single localization string can produce grammatically correct output.

|1 — Korean Postpositions

text|1A;B;

Selects postposition A (after consonant) or B (after vowel).

print("라면|1을;를;")  -- 라면을 (ramyeoneul)
print("나무|1을;를;")  -- 나무를 (namureul)

|2 — French Prepositions

|2 text

Outputs de text before a consonant, d'text before a vowel. Trailing spaces after |2 are ignored.

print("|2 fraise") -- de fraise
print("|2 avion")  -- d'avion

|3 — Russian Noun Declension

|3-id(text)

Declines a Russian noun into one of 5 cases (id = 1–5).

print("|3-1(Кролик)") -- Кролика   (Genitive)
print("|3-2(Кролик)") -- Кролику   (Dative)
print("|3-3(Кролик)") -- Кролика   (Accusative)
print("|3-4(Кролик)") -- Кроликом  (Instrumental)
print("|3-5(Кролик)") -- Кролике   (Prepositional)

See also: DeclineName() API.

|4 — Plural Forms

number |4singular:plural;
number |4singular:plural1:plural2;   -- ruRU has three forms

Selects singular or plural based on the preceding number.

print("1 |4car:cars;")      -- 1 car
print("2 |4car:cars;")      -- 2 cars
print("3 blue |4car:cars;") -- 3 blue cars

|7 — Plural (Large Numbers / Non-English)

Same behavior as |4 but used specifically with large numbers on certain non-English locales.

print("1 |7Million:Millionen;") -- 1 Million
print("2 |7Million:Millionen;") -- 2 Millionen

|5 — Indefinite Article (a / an)

|5 text
|5^ text   -- uppercase article

Inserts a before consonant sounds, an before vowel sounds.

print("|5 banana")  -- a banana
print("|5 apple")   -- an apple
print("|5^ apple")  -- An apple

|6 — Lowercase

|6 TEXT
|6(TEXT MORE)

Converts the next word (or parenthesized group) to lowercase.

print("|6 HELLO WORLD")  -- hello WORLD
print("|6(HELLO WORLD)") -- hello world

Word Wrapping

|Wtext|w

Hints that the enclosed text should not be broken across lines. If the text would require wrapping, the client prefers to wrap before the |W start instead of splitting inside it. If the text is still too wide, the hint may be ignored.

Added in Patch 5.4.1.

Other Sequences

Utility Functions (FrameXML)

These FrameXML helper functions generate escape-sequence markup:

-- Color a string red
WrapTextInColorCode("Critical!", "FFFF0000")
-- "|cFFFF0000Critical!|r"

-- Inline 16×16 coin icon
CreateSimpleTextureMarkup("Interface/Icons/INV_Misc_Coin_01", 16, 16)
-- "|TInterface/Icons/INV_Misc_Coin_01:16:16|t"

-- Atlas tank icon
CreateAtlasMarkup("groupfinder-icon-role-large-tank", 16, 16)
-- "|A:groupfinder-icon-role-large-tank:16:16|a"

Patch History

See Also

• Hyperlinks — related pipe-delimited link sequences (|H...|h...|h).
• wow-api-framexml skill — covers WrapTextInColorCode, CreateTextureMarkup, CreateSimpleTextureMarkup, CreateAtlasMarkup in detail.
• wow-api-widget skill — covers FontString, GameTooltip, and other widgets that render these sequences.