Troubleshooting

Solutions to common issues and debugging tips for Power UI Theme Studio.

Quick Fixes

Try these common solutions first for most issues:

Refresh the Page

Many issues resolve with a simple page refresh. Your work is auto-saved locally.

Clear Browser Cache

Clear cache and cookies for powerui.app if experiencing persistent issues.

Check Internet Connection

Power UI requires a stable internet connection for preview and saving features.

Update Browser

Use latest Chrome, Edge, Firefox, or Safari for best compatibility.

Common Issues & Solutions

Preview not updating or loading

Symptoms:

  • • Preview stays blank or frozen
  • • Changes don't reflect in preview
  • • Loading spinner persists

Solutions:

  1. 1.Wait 2-3 seconds for automatic update
  2. 2.Click the refresh button in preview controls
  3. 3.Switch to JSON view and back to Preview
  4. 4.Check browser console for errors (F12)
  5. 5.Ensure ad blockers aren't interfering
Unable to save theme

Symptoms:

  • • Save button doesn't respond
  • • Error message when saving
  • • Changes lost after refresh

Solutions:

  1. 1.Verify you're logged in
  2. 2.Check internet connectivity
  3. 3.Export as backup before troubleshooting
  4. 4.Try saving with a different theme name
  5. 5.Check browser storage quota (may be full)
Theme import failing

Symptoms:

  • • "Invalid JSON" error
  • • Import dialog won't accept file
  • • Theme doesn't load after import

Solutions:

  1. 1.Validate JSON at jsonlint.com
  2. 2.Ensure file has .json extension
  3. 3.Check for Power BI theme structure
  4. 4.Remove custom properties not supported
  5. 5.Try paste method instead of file upload
Exported theme not working in Power BI

Symptoms:

  • • Power BI rejects theme file
  • • Theme applies but looks wrong
  • • Missing style variants

Solutions:

  1. 1.Save theme before exporting
  2. 2.Update Power BI Desktop to latest version
  3. 3.Test on a new blank report first
  4. 4.Check for special characters in theme name
  5. 5.Verify JSON validity in exported file
Visual selection sync not working

Symptoms:

  • • Clicking visual doesn't update panels
  • • Wrong visual type selected
  • • Selection highlighting missing

Solutions:

  1. 1.Click directly on the visual, not the container
  2. 2.Wait for visual to highlight before checking
  3. 3.Some custom visuals don't support selection
  4. 4.Try manual selection in Visual Styles dropdown
Style variants not appearing in Power BI

Symptoms:

  • • Only default style shows
  • • Style presets menu missing
  • • Variants don't apply correctly

Solutions:

  1. 1.Right-click visual → Format → Style presets
  2. 2.Ensure visual type supports variants
  3. 3.Check theme JSON includes variant definitions
  4. 4.Some custom visuals don't support variants

Performance Issues

If Theme Studio is running slowly:

Browser Optimization

  • • Close unnecessary tabs
  • • Disable unused extensions
  • • Clear browser cache
  • • Use hardware acceleration

Theme Optimization

  • • Reduce number of variants
  • • Simplify complex themes
  • • Remove unused properties
  • • Clean up JSON structure

Browser Compatibility

BrowserSupportNotes
Chrome (90+)Recommended
Edge (90+)Fully supported
Firefox (88+)Fully supported
Safari (14+)Fully supported
Internet ExplorerNot supported

Common Error Messages

"Invalid JSON structure"

The imported file contains syntax errors. Validate at jsonlint.com and fix any issues.

"Theme save failed"

Check internet connection and login status. Export as backup before retrying.

"Preview unavailable"

Power BI embed service may be temporarily unavailable. Try again in a few minutes.

Getting Additional Help

Support Resources

Self-Service

  • • Review this documentation
  • • Check browser console (F12)
  • • Try incognito/private mode
  • • Test with sample themes

Contact Support

  • • Email: support@powerui.app
  • • Include theme URL if applicable
  • • Describe steps to reproduce
  • • Attach screenshots if helpful

Debug Checklist

When reporting issues, please check:

← Back to Documentation