Reference
Widget Variables
A complete reference for the user-data fields used by WoWidget and Discord's Widget Editor.
Match every field exactly.
Discord connects a widget element to WoWidget by its Data Field name and Presentation Type. A spelling or type mismatch prevents the value from appearing.
Widget Top
Identity and hero fields
These fields build the main character area of the widget.
character_modelImageCharacter Portrait
The portrait saved in Portrait Studio and displayed in the Hero image area.
character_nameTextCharacter Name
The selected character's display name.
race_classTextRace and Class
A combined identity string such as “Blood Elf Demon Hunter.”
realmTextRealm
The realm associated with the active character.
guildTextGuild Name
The character's current guild, or the application's fallback when no guild is returned.
faction_iconImageFaction Icon
The Alliance or Horde icon associated with the character.
Widget Bottom
Required specialization fields
Use these together for the first Stats Grid slot.
spec_nameTextCurrent Specialization
The active specialization name used as the first stat value.
spec_iconImageSpecialization Icon
The icon corresponding to the active character specialization.
Stats 2–6
Optional statistics
Choose any five fields supported by your current WoWidget build.
| Display name | Presentation type | Data field | Description |
|---|---|---|---|
| Item Level | Number | gear_score | Current equipped item level. |
| Mythic+ Rating | Number | mythic_score | Current Mythic+ rating returned by Blizzard. |
| Mythic+ Rating (Exact) | Text | mythic_score2 | Exact Mythic+ rating with thousands separators, such as 3,428. |
| PvP Rating | Text | pvp_score | Current supported PvP rating. |
| Raid Progress | Text | raid_score | Combined current-season raid progression. |
| Achievements | Number | a_score | Total achievement points. |
| Achievements (Exact) | Text | a_score2 | Exact achievement points with thousands separators, such as 27,345. |
| Achievements Icon | Image | a_icon | Achievement icon for use alongside either Achievements field. |
| Mounts | Number | mount_score | Number of collected mounts. |
| Pets | Number | pet_score | Number of collected companion pets. |
| Titles | Number | title_score | Number of unlocked character titles. |
| Feats of Strength | Number | feats_score | Completed Feats of Strength. |
| Exalted Reputations | Number | rep_score | Number of reputations at Exalted. |
| Last Logged In | Text | last_login | Elapsed time since the character last logged in. |
| Character Level | Number | character_level | Current character level. |
Configuration rules
Common field requirements
Use exact Data Field values
Field names are case-sensitive. Do not add spaces, capitalization, or punctuation that is not shown in this reference.
Match the Presentation Type
A Number field must be configured as Number, an image field as Image, and last_login as Text.
Save and publish changes
After editing variables in Discord, select Save Changes and Publish, then run a WoWidget update.