Getting Started · Step 4 of 5

Widget Setup

Build the Discord profile widget and connect every visual element to the exact User Data variable that WoWidget updates.

⏱ 12–18 minutesExact configuration required

Before you begin

Open your Discord application and select Widget from the Games section. If the Widget tab is missing, repeat Discord Setup, Step 6.

1

Create the widget

Select Create Widget.

Open the Widget section and create a new widget.

2

Configure Widget Top

Choose Widget Top from the dropdown, select the Hero layout, and open the Content tab. Hero gives the character model more room and blends it into the widget more naturally than Contained.

Select Widget Top.

Choose Hero layout.

Open the Content tab.

1 · Image

Image

Value Type	User Data
Data Field	character_model
Fallback	Disabled

2 · Title

Text

Presentation Type	Text
Value Type	User Data
Data Field	character_name
Fallback	Disabled

3 · Subtitle 1

Text + Icon

Label	Disabled	Presentation Type	Text
Value Type	User Data	Data Field	race_class
Fallback	Disabled	Icon	Enabled
Icon Value Type	User Data	Icon Data Field	faction_icon

4 · Subtitle 2

Label + Text

Label	Enabled	Label Value Type	Custom String
Label Content	Realm	Presentation Type	Text
Value Type	User Data	Data Field	realm
Fallback	Disabled	Icon	Disabled

5 · Subtitle 3

Label + Text

Label	Enabled	Label Value Type	Custom String
Label Content	Guild	Presentation Type	Text
Value Type	User Data	Data Field	guild
Fallback	Enabled — N/A	Icon	Disabled

3

Configure Widget Bottom

Choose Widget Bottom, select the Stats Grid layout, and open the Content tab. Stat 1 is recommended to be your current spec; slots 2–6 can use any five variables from the table below.

Select Widget Bottom, and choose Stats Grid.

Open Content and input your chosen stats.

Stat 1 · Current Spec

Required

Presentation Type	Text	Value Type	User Data
Data Field	spec_name	Fallback	Disabled
Label	Enabled	Label Value Type	Custom String
Label Content	Current Spec	Icon	Enabled
Icon Value Type	User Data	Icon Data Field	spec_icon

Stats 2–6

Choose five optional variables

Match both the Presentation Type and Data Field exactly.

Display name	Presentation type	Data field	What it displays
Item Level	Number	gear_score	Current equipped item level
Mythic+ Rating	Number	mythic_score	Current Mythic+ score
Mythic+ Rating (Exact)	Text	mythic_score2	Exact Mythic+ score with thousands separators
PvP Rating	text	pvp_score	Current PvP rating
Raid Progress	Text	raid_score	Combined current-season raid progress
Achievements	Number	a_score	Total achievement points
Achievements (Exact)	Text	a_score2	Exact achievement points with thousands separators
Achievements Icon	Image	a_icon	Achievement icon for use with either Achievements field
Mounts	Number	mount_score	Collected mount count
Pets	Number	pet_score	Collected companion pet count
Titles	Number	title_score	Unlocked title count
Feats of Strength	Number	feats_score	Completed Feats of Strength
Exalted Reputations	Number	rep_score	Exalted reputation count
Last Logged In	text	last_login	Time elapsed since the character last logged in
Character Level	Number	character_level	Current character level

4

Add Widget Preview

Choose Add Widget Preview, select the Hero layout, and configure Image using the same character_model User Data variable used in Widget Top.

Add the required profile preview.

Use character_model for the Hero preview image.

5

Configure Mini Profile (optional)

Enable the compact widget shown on your profile card in servers. The recommended setup is your character name as the stat, either faction_icon or spec_icon as the icon, and character_model as the image.

Optionally configure the compact profile-card version.

6

Save and publish

Select Save Changes in the upper-right corner, then select Publish.

Save the configuration, then publish the widget.

Enable Developer Mode

If you followed these steps and still can't add the widget to your Discord profile, make sure you have Devloper Mode enabled in your discord settings. Because these features are considered 'Experimental', the developer mode must be enabled to use them.