WoWidget Support

Troubleshooting

Find the symptom or error message you are seeing, then expand it for the most likely cause and the exact steps to resolve it.

Start with the quick checks Confirm that WoWidget is open, your internet connection is working, Discord is running, and the character shown in WoWidget is the one you intend to update. Many temporary failures are resolved by closing and reopening WoWidget once.

Category 1

Installation

Windows, installer, and startup issues
! Windows says “Windows protected your PC”Microsoft Defender SmartScreen blocks the installer.

Why this happens

WoWidget is currently distributed without a commercial code-signing certificate. SmartScreen often warns about unsigned applications until they have established reputation.

Resolution

  1. Confirm that the installer came from the official WoWidget GitHub Releases page.
  2. Select More info in the SmartScreen window.
  3. Select Run anyway.
↓ The installer does not openNothing happens after double-clicking the downloaded installer.

Likely causes

  • The download was incomplete or corrupted.
  • Windows Security or another antivirus product quarantined the file.
  • A previous installer process is still running in the background.

Resolution

  1. Delete the downloaded installer and download a fresh copy from GitHub Releases.
  2. Open Windows Security → Virus & threat protection → Protection history and check whether the installer was blocked.
  3. Restart Windows, then run the installer again.
▣ WoWidget appears to open, then disappearsThe application may already be running in the system tray.

Why this happens

If Start application minimized is enabled, WoWidget can launch directly into the Windows notification area instead of opening a full window.

Resolution

  1. Select the Show hidden icons arrow near the Windows clock.
  2. Locate the WoWidget icon and open it.
  3. To change this behavior, open Settings and disable Start application minimized.
↻ WoWidget behaves incorrectly after an updateA previous installation may not have been replaced cleanly.

Resolution

  1. Close WoWidget completely, including its system-tray process.
  2. Run the newest installer again and allow it to replace the existing version.
  3. Restart WoWidget and test the same action once more.

Your stored credentials are kept separately in Windows Credential Manager and normally do not need to be entered again.

Category 2

Blizzard

Developer credentials and character-data issues
B “Credential validation failed” for BlizzardThe Client ID or Client Secret could not be authenticated.

Common causes

  • The Client ID and Client Secret were pasted into the opposite fields.
  • A leading or trailing space was copied with one of the values.
  • The Blizzard client was deleted or regenerated after the values were copied.

Resolution

  1. Return to your Blizzard Developer Portal client.
  2. Copy the Client ID and Client Secret again.
  3. Paste each value into its matching WoWidget field without editing it.
  4. Select Validate and Continue once.

Review the Blizzard Setup guide →

? “Character lookup failed” or character not foundBlizzard could not match the region, realm, and character combination.

Resolution

  1. Confirm the correct region is selected.
  2. Enter the realm’s displayed name without extra punctuation or spaces.
  3. Confirm the character name is spelled correctly.
  4. Log into the character in World of Warcraft once, log out normally, wait a few minutes, and search again.

Still not found?

Recently transferred, renamed, restored, or newly created characters can take time to appear through Blizzard’s profile API.

⌁ “Unable to contact Blizzard”The Blizzard API request timed out or returned a temporary service error.

Resolution

  1. Confirm that your internet connection is working.
  2. Wait several minutes and try again.
  3. Check whether a VPN, firewall, DNS filter, or antivirus web shield is blocking WoWidget.
  4. If other Blizzard services are also unavailable, wait for service to recover.
↺ Character data looks old or incompleteItem level, Mythic+, raid progress, or collections have not caught up yet.

Why this happens

WoWidget displays data returned by Blizzard. Some profile information is cached and does not update immediately after every in-game change.

Resolution

  1. Log out of the character normally so Blizzard can update the profile.
  2. Wait several minutes.
  3. Select Update Widget Now again.

Category 3

Discord

OAuth, Social SDK, tokens, and authorization
! “Discord Authorization Cancelled” or “scope is invalid, unknown or malformed”The Discord Social SDK setup form has not been completed.

Resolution

  1. Open your application in the Discord Developer Portal.
  2. Open Social SDK under the Games section.
  3. Complete every required field, accept the privacy-policy acknowledgement, and submit the form.
  4. Return to WoWidget and select Authorize Discord again.

Go to Discord Setup: Social SDK Form →

↪ Discord reports an invalid or mismatched redirect URIThe OAuth redirect in the Developer Portal does not exactly match WoWidget.

Resolution

  1. Open OAuth2 in your Discord application.
  2. Add the following redirect exactly as written:
http://127.0.0.1:5001/callback
  1. Select Save Changes.
  2. Try authorization again.
5001 “Could not start the Discord authorization callback on port 5001”Another program is already using WoWidget’s local callback port.

Resolution

  1. Close any other WoWidget window or background instance.
  2. Close local development servers or other applications using port 5001.
  3. Restart WoWidget and authorize again.
  4. If necessary, restart Windows to release the port.
⌛ “Discord authorization timed out”The browser authorization was not completed before WoWidget stopped waiting.

Resolution

  1. Close the old Discord authorization tab.
  2. Select Authorize Discord again.
  3. Complete the browser prompt without refreshing or opening a second authorization attempt.
⌁ “Discord returned an invalid OAuth state”The callback did not match the authorization attempt WoWidget started.

Resolution

  1. Close all open Discord authorization tabs.
  2. Restart WoWidget.
  3. Start one new authorization attempt and complete only that tab.
@ The wrong Discord account was authorizedYour browser was already signed into another Discord account.

Resolution

  1. Open WoWidget Settings.
  2. Authorize Discord again.
  3. In the browser, sign out of the incorrect Discord account or use a private window with the intended account.
  4. Confirm the displayed account name before accepting.
↻ “Discord token refresh failed” or Discord becomes unauthorizedThe saved OAuth session expired or was revoked.

Resolution

  1. Open WoWidget Settings.
  2. Select Authorize Discord.
  3. Accept the browser authorization request again.
# The Discord Bot Token is rejectedThe token is missing, incomplete, reset, or copied from the wrong field.

Resolution

  1. Open Bot in the Discord Developer Portal.
  2. Select Reset Token only if you no longer have the current token.
  3. Copy the full Bot Token and paste it into WoWidget.
  4. Do not use the Public Key, Application ID, or Client Secret in the Bot Token field.

Category 4

Widget Editor

Experimental editor, publishing, and variables
W The Widget tab is missingThe experimental Widget Editor has not been enabled for the current portal session.

Resolution

  1. Return to the Discord Developer Portal home screen using the portal’s back arrow.
  2. Repeat the experimental Widget Editor enablement step in your browser console.
  3. Close Developer Tools and reopen your Discord application.

Review Discord Setup: Experimental Widget Editor →

↺ The Widget tab disappeared after refreshing the pageExperimental access is temporary and tied to the current portal session.

Resolution

Repeat the Widget Editor enablement step. Avoid refreshing the Developer Portal until the widget has been saved and published.

↑ The widget cannot be published or added to the profileThe required Widget Preview may be missing.

Resolution

  1. Use the Widget Editor dropdown and select Add Widget Preview.
  2. Choose the Hero layout.
  3. Configure its image with the required character_model User Data field.
  4. Select Save changes, then Publish.

Review Widget Setup: Widget Preview →

_ A widget field is blank or never updatesThe Data Field, Value Type, Presentation Type, or fallback does not match WoWidget.

Most common cause

User Data variable names are exact and case-sensitive. Even a small spelling difference creates a different variable.

Resolution

  1. Compare the field against the Widget Setup guide.
  2. Confirm the exact Data Field name.
  3. Confirm the required Value Type and Presentation Type.
  4. Save and publish the widget again.
  5. Return to WoWidget and select Update Widget Now.
▧ The character image does not appearThe image element or preview is using the wrong Data Field.

Required configuration

  • Value Type: User Data
  • Data Field: character_model
  • Fallback: Disabled

Use the same image field in both Widget Top and Widget Preview.

◇ The faction or specialization icon is missingThe icon control is disabled or points to the wrong User Data field.

Resolution

  • For Widget Top Subtitle 1, enable the icon and use faction_icon.
  • For the Current Spec stat, enable the icon and use spec_icon.
  • Set the icon Value Type to User Data.
N/A A statistic displays “Unavailable” or “N/A”WoWidget may not have usable data for that character and statistic.

Examples

  • A character with no current PvP rating.
  • A character with no progression in the tracked raid tier.
  • A Blizzard profile endpoint that does not expose the requested value.

Resolution

Choose a different statistic for that slot, or configure an appropriate fallback in the Widget Editor where supported.

◷ Last Logged In displays an incorrect numberThe field is not configured with Discord’s Duration presentation.

Required configuration

  • Presentation Type: Duration
  • Data Field: last_login

Do not configure last_login as plain Text or Number.

Category 5

WoWidget Application

Updates, portraits, background service, and settings
🔒 “Unable to save setup information” or “Unable to save credential”Windows Credential Manager could not store one of WoWidget’s secrets.

Resolution

  1. Close WoWidget and restart Windows.
  2. Open WoWidget normally and retry validation.
  3. Confirm that Windows Credential Manager is available and that security software is not blocking credential storage.
  4. If the error continues, open Credential Manager → Windows Credentials, remove stale entries named WoWidget, then repeat setup.

Note: Removing WoWidget credentials requires you to enter and authorize them again.

↥ “Update Widget Now” failsThe most recent error may come from Blizzard, Discord, image upload, or authorization.

Resolution

  1. Read the exact Last Error shown on the WoWidget dashboard.
  2. If Discord is unauthorized, open Settings and authorize it again.
  3. If Blizzard cannot be contacted, wait briefly and retry.
  4. If the portrait upload fails, use Repair Upload Registration in Settings, then update again.
☁ Portrait upload or upload registration failsWoWidget’s installation token may be missing or no longer valid.

Resolution

  1. Open WoWidget Settings.
  2. Select Repair Upload Registration.
  3. Wait for the success message.
  4. Select Update Widget Now again.
↗ The browser does not open when authorizing DiscordWindows could not open the authorization URL with the default browser.

Resolution

  1. Confirm that Windows has a default web browser configured.
  2. Close and reopen WoWidget.
  3. Temporarily disable browser pop-up restrictions or security software that intercepts links.
  4. Select Authorize Discord again.
✦ The portrait does not generateThe character render could not be downloaded or processed.

Resolution

  1. Confirm the selected character is correct.
  2. Check your internet connection.
  3. Wait a few minutes and select Generate Portrait again.
  4. If Blizzard does not provide a usable render for the character, try again after logging into that character and logging out normally.
⌖ The portrait is cropped or positioned poorlyThe saved crop does not account for the widget’s fade and visible area.

Resolution

  1. Open the Portrait Editor.
  2. Move the character toward the top-right of the visible crop area.
  3. Keep important details away from the left-side fade region.
  4. Select Save Portrait, then update the widget and review the result.
  5. Repeat as needed; saving another crop does not require regenerating the raw render.

Open the Portrait Studio guide →

⟳ Automatic updates are not runningWoWidget must remain open and automatic updates must be enabled.

Resolution

  1. Open Settings and confirm automatic updates are enabled.
  2. Confirm the update interval is set to the value you expect.
  3. Keep WoWidget running; minimizing it is fine, but fully exiting stops the timer.
  4. Check the dashboard for the last update time and any displayed error.
⊞ Launch with Windows does not workThe startup entry could not be created or has been disabled by Windows.

Resolution

  1. Open WoWidget Settings.
  2. Disable Launch with Windows, save, then enable it again and save.
  3. Open Windows Settings → Apps → Startup and confirm WoWidget is permitted.
  4. If a security utility manages startup items, allow WoWidget there as well.
✓ Widget Editor changes do not appear on the profilePublishing the layout and pushing new User Data are separate actions.

Resolution

  1. In the Discord Widget Editor, select Save changes.
  2. Select Publish.
  3. Return to WoWidget and select Update Widget Now.
  4. Reopen or refresh your Discord profile after the update completes.

Category 6

Advanced Recovery

Use these only after the targeted fix above has failed
… Open WoWidget’s application-data folderUseful when collecting diagnostic information or reviewing generated portraits.

Recommended method

Open WoWidget Settings and use the built-in button to open the application-data folder. This avoids manually navigating to hidden Windows directories.

↺ Reset saved Discord authorizationUse when repeated reauthorization attempts continue to use broken or stale credentials.

Resolution

  1. Close WoWidget.
  2. Open Control Panel → Credential Manager → Windows Credentials.
  3. Remove WoWidget entries related to Discord authorization.
  4. Reopen WoWidget and complete Discord authorization again.

Use caution: Removing all WoWidget entries also removes Blizzard and Discord setup credentials, requiring complete setup again.

× Perform a complete WoWidget resetLast-resort recovery when the installation and saved configuration are both unusable.

Before continuing

This removes your saved setup and requires you to repeat Blizzard, Discord, Widget, and Application setup.

Resolution

  1. Save copies of your Blizzard and Discord developer credentials.
  2. Close and uninstall WoWidget.
  3. Remove WoWidget entries from Windows Credential Manager.
  4. Remove the WoWidget application-data folder using the location opened from Settings before uninstalling, if available.
  5. Install the newest release and repeat the setup guides from the beginning.

Still stuck?

Report an issue with useful details

Include the exact error text, the action that triggered it, your WoWidget version, and a screenshot with all secrets hidden.

✓ Exact error message ✓ WoWidget version ✓ Steps to reproduce ✓ Redacted screenshot
Open a GitHub Issue