Discord User Data

Widget Variables

A complete reference for the user-data fields used by WoWidget and Discord's Widget Editor.

Text, number, duration, and image fieldsNames are case-sensitive
{ }

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.

Open Widget Editor guide

Widget Top

Identity and hero fields

These fields build the main character area of the widget.

character_model
Image

Character Portrait

The portrait saved in Portrait Studio and displayed in the Hero image area.

Recommended use: Widget Top image and Widget Preview
character_name
Text

Character Name

The selected character's display name.

Recommended use: Title
race_class
Text

Race and Class

A combined identity string such as “Blood Elf Demon Hunter.”

Recommended use: Subtitle 1
realm
Text

Realm

The realm associated with the active character.

Recommended label: Realm:
guild
Text

Guild Name

The character's current guild, or the application's fallback when no guild is returned.

Recommended label: Guild:
faction_icon
Image

Faction Icon

The Alliance or Horde icon associated with the character.

Recommended use: Race/Class subtitle icon

Widget Bottom

Required specialization fields

Use these together for the first Stats Grid slot.

spec_name
Text

Current Specialization

The active specialization name used as the first stat value.

Recommended label: Current Spec
spec_icon
Image

Specialization Icon

The icon corresponding to the active character specialization.

Recommended use: Stat 1 icon

Stats 2–6

Optional statistics

Choose any five fields supported by your current WoWidget build.

Select Copy beside any Data Field to place its exact value on your clipboard.

Optional statistics

Character

General character and account activity fields.

Display namePresentation typeData fieldDescription
Character LevelNumber
character_level
Current character level.
Last Logged InText
last_login
Elapsed time since the character last logged in.

Optional statistics

Progression

Core equipment, Mythic+, and raid progression fields.

Display namePresentation typeData fieldDescription
Item LevelNumber
gear_score
Current equipped item level.
Mythic+ RatingNumber
mythic_score
Current Mythic+ rating returned by Blizzard.
Mythic+ Rating (Exact)Text
mythic_score2
Exact Mythic+ rating with thousands separators, such as 3,428.
Raid ProgressText
raid_score
Highest current-season progression, prioritizing Mythic, then Heroic, Normal, and Raid Finder.
Heroic Raid ProgressText
heroic_score
Current-season Heroic progression only.
Normal Raid ProgressText
normal_score
Current-season Normal progression only.

Optional statistics

PvP

Queue-specific ratings are sent as Text so Discord displays the complete value without abbreviation.

Display namePresentation typeData fieldDescription
Highest PvP RatingText
pvp_score
Highest rating across every supported PvP queue and specialization.
Solo Shuffle RatingText
solo_score
Highest Solo Shuffle rating across all specializations.
2v2 Arena RatingText
two_score
Highest 2v2 Arena rating across all specializations.
3v3 Arena RatingText
three_score
Highest 3v3 Arena rating across all specializations.
Battleground Blitz RatingText
blitz_score
Highest Battleground Blitz rating across all specializations.
Rated Battleground RatingText
rbg_score
Highest Rated Battleground rating across all specializations.

Optional statistics

Collections

Collection totals available for the selected character.

Display namePresentation typeData fieldDescription
MountsNumber
mount_score
Number of collected mounts.
PetsNumber
pet_score
Number of collected companion pets.
TitlesNumber
title_score
Number of unlocked character titles.

Optional statistics

Completion

Achievement and reputation completion fields.

Display namePresentation typeData fieldDescription
AchievementsNumber
a_score
Total achievement points.
Achievements (Exact)Text
a_score2
Exact achievement points with thousands separators, such as 27,345.
Achievements IconImage
a_icon
Achievement icon for use alongside either Achievements field.
Feats of StrengthNumber
feats_score
Completed Feats of Strength.
Exalted ReputationsNumber
rep_score
Number of reputations at Exalted.

Configuration rules

Common field requirements

Names

Use exact Data Field values

Field names are case-sensitive. Do not add spaces, capitalization, or punctuation that is not shown in this reference.

Types

Match the Presentation Type

A Number field must be configured as Number, an image field as Image, and last_login as Text.

Publishing

Save and publish changes

After editing variables in Discord, select Save Changes and Publish, then run a WoWidget update.