Troubleshooting Guide: Common Issues and Solutions

Quick fixes for the most common AI art generation problems

Table of Contents

1. Generation Issues
2. Quality and Results Problems
3. Technical and Performance Issues
4. Interface and UI Problems
5. Storage and Data Issues
6. Error Messages Reference
7. Emergency Fixes
8. Getting Additional Help

---

Generation Issues

❌ Generation Won't Start

Symptom: Clicking "Generate Image" does nothing or shows error immediately

Quick Checks:

1. ✅ Is there text in the prompt box?
2. ✅ Is the terms agreement checkbox checked?
3. ✅ Are you connected to the internet?
4. ✅ Do you have fewer than 20 active generations?

Solutions:

• Empty Prompt: Add any text to the prompt box
• Terms Not Agreed: Scroll down and check the agreement checkbox
• Connection Issues: Check your internet connection, refresh page
• Job Limit: Wait for some generations to complete, then try again
• Browser Issues: Try refreshing the page (Ctrl+F5 or Cmd+Shift+R)

❌ Generation Stuck in Queue Forever

Symptom: Generation shows "Queued" status for over 10 minutes

Immediate Actions:

1. Check network status - Look for connectivity issues
2. Try canceling and regenerating - Click cancel, then try again
3. Switch models - Popular models may have longer queues
4. Reduce batch size - Generate fewer images at once

Model-Specific Solutions:

• Try FLUX.1 [Schnell] for faster queues
• Avoid peak hours (evenings in US/Europe)
• Enable "Allow Downgrades" in advanced settings
• Use smaller image sizes (512×512 or 768×768)

❌ Generation Fails Immediately

Symptom: Generation starts but fails within seconds

Common Causes & Fixes:

• Prompt contains banned words: Simplify your prompt, avoid explicit content
• Model unavailable: Try different model or enable downgrades
• Invalid settings: Reset to default settings and try again
• Server overload: Wait 5-10 minutes and retry

Quick Reset Method:

1. Clear your prompt
2. Set quality to "Standard"
3. Set size to "Square (1024×1024)"
4. Try a simple prompt: "A beautiful flower in sunlight"

---

Quality and Results Problems

❌ Images Are Always Blurry or Low Quality

Immediate Fixes:

1. Add quality terms to your prompt:

   highly detailed, sharp focus, best quality, masterpiece

2. Use negative prompts:

   blurry, low quality, soft focus, out of focus, worst quality

3. Increase quality setting:

   • Change from Fast → Standard → High

4. Try different models:

   • Switch to AlbedoBase XL or Juggernaut XL

Advanced Solutions:

• Enable Hi-Res Fix in advanced settings
• Increase CFG scale to 7-8 range
• Use 4× upscaler for enhanced details
• Generate larger base images (1024×1024 minimum)

❌ People Look Deformed or Wrong

Symptom: Extra limbs, wrong anatomy, distorted faces

Quick Fixes:

1. Add to your prompt:

   good anatomy, well proportioned, realistic proportions

2. Add to negative prompt:

   deformed, ugly, bad anatomy, extra limbs, malformed limbs

3. Simplify poses:

   • Avoid complex hand positions
   • Use straightforward poses
   • Focus on head/shoulders for portraits

Model Recommendations:

• For people: Use Juggernaut XL or AlbedoBase XL
• Enable face fixing in post-processing
• Generate multiple images to find better results

❌ Colors Look Wrong or Ugly

Color Correction Methods:

1. Specify desired colors:

   warm colors, golden hour lighting, natural colors

2. Fix color issues:

   balanced colors, professional color grading, vibrant but natural

3. Negative prompt fixes:

   oversaturated, muddy colors, washed out, color noise

4. Try different lighting:

   • "natural lighting"
   • "soft lighting"
   • "cinematic lighting"

❌ AI Doesn't Understand My Prompt

Symptom: Results don't match what you described

Troubleshooting Steps:

1. Simplify your language:

   • ❌ "A person exhibiting jubilant expressions"
   • ✅ "A happy person smiling"

2. Be more specific:

   • ❌ "A nice scene"
   • ✅ "A mountain lake at sunset with trees"

3. Use familiar references:

   in the style of Studio Ghibli like a Disney character medieval fantasy setting

4. Break complex ideas apart:

   • Instead of one complex prompt
   • Try multiple simpler generations
   • Combine elements later

---

Technical and Performance Issues

❌ Browser Running Slowly or Freezing

Immediate Actions:

1. Close other tabs - Free up memory
2. Clear browser cache - Ctrl+Shift+Delete (or Cmd+Shift+Delete on Mac)
3. Restart browser - Close completely and reopen
4. Check available storage - Delete old images if needed

Performance Optimization:

• Reduce concurrent generations to 5 or fewer
• Clear old images from gallery regularly
• Use latest browser version
• Close heavy applications while generating

❌ Images Won't Download or Save

Quick Solutions:

1. Right-click image → "Save image as"
2. Check download folder - May be saved elsewhere
3. Disable download blockers - Check browser settings
4. Try different browser - Chrome, Firefox, Safari

Browser-Specific Fixes:

Chrome:

• Check Settings → Advanced → Downloads
• Disable "Ask where to save each file" if enabled

Firefox:

• Check Preferences → General → Downloads
• Change download location if needed

Safari:

• Check Safari → Preferences → General → File download location

❌ Generation Queue Not Updating

Symptom: Progress stuck at same percentage or status

Fixes:

1. Refresh the page - Don't worry, generations continue
2. Check internet connection - Stable connection required
3. Clear browser cache - May resolve sync issues
4. Try different browser - Sometimes browser-specific

If Refresh Doesn't Help:

• Generations resume automatically when page reloads
• Check "Your Gallery" section for completed images
• Cancel stuck generations and start fresh

---

Interface and UI Problems

❌ Buttons Not Working or Clicking

Common Solutions:

1. Hard refresh: Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
2. Disable browser extensions temporarily
3. Try incognito/private mode
4. Clear cookies and cache

❌ Dialogs or Modals Won't Open

Fixes:

• Disable popup blockers for the site
• Try different browser
• Check for JavaScript errors (F12 → Console tab)
• Reset browser settings if persistent

❌ Settings Not Saving

Troubleshooting:

1. Allow cookies for the site
2. Clear site data and reload
3. Check browser storage permissions
4. Try different browser

---

Storage and Data Issues

❌ "Storage Quota Exceeded" Error

Immediate Actions:

1. Delete old images you don't need
2. Download important images first
3. Clear browser data for the site
4. Check available disk space

Prevention:

• Regular cleanup - Delete images monthly
• Download favorites - Keep copies outside browser
• Monitor storage - Check usage in settings

❌ Images Disappeared

Recovery Steps:

1. Check browser storage - Look in IndexedDB
2. Try different browser profile - May be in different profile
3. Check download folder - May have been auto-downloaded
4. Refresh page - Sometimes display issue

Prevention for Future:

• Download important images immediately
• Don't use incognito mode for serious work
• Regular backups of favorites

❌ History/Prompts Lost

Recovery:

• Check different browser - Data is browser-specific
• Look for exported data - Check downloads
• Try browser recovery tools - Some browsers have built-in recovery

Prevention:

• Export prompt history regularly
• Keep text file of favorite prompts
• Use consistent browser for AI art work

---

Error Messages Reference

"Generation Failed - Worker Error"

Cause: The AI worker encountered a problem Solution: Try again with same settings, or simplify prompt

"Queue Position Lost"

Cause: Network interruption during generation Solution: Generation will retry automatically, check connection

"Model Not Available"

Cause: Selected model temporarily unavailable Solution: Enable "Allow Downgrades" or try different model

"Invalid Parameters"

Cause: Settings outside acceptable ranges Solution: Reset to default settings, adjust gradually

"Network Error - Retry"

Cause: Connection problems Solution: Check internet, wait a moment, try again

"Storage Full - Cannot Save"

Cause: Browser storage limit reached Solution: Delete old images, clear browser data

---

Emergency Fixes

🚨 Nothing Works - Nuclear Option

Complete Reset Procedure:

1. Export/download any important images first
2. Clear all site data:
   • Chrome: Settings → Privacy → Site Settings → View permissions and data → Find site → Clear data
   • Firefox: Preferences → Privacy → Cookies and Site Data → Manage Data → Find site → Remove
3. Clear cache and cookies
4. Restart browser
5. Visit site again - Will be like first visit

🚨 Page Won't Load at All

Steps:

1. Try different browser
2. Try incognito/private mode
3. Check internet connection
4. Try different device (phone, tablet)
5. Wait and try later - May be temporary server issue

🚨 Constant Crashes or Freezes

System-Level Fixes:

1. Restart computer
2. Update browser to latest version
3. Check system memory - Close other applications
4. Try different device if available
5. Contact system administrator if on work/school network

---

Getting Additional Help

Self-Help Resources

Check First:

• Refresh the page - Fixes 70% of issues
• Try incognito mode - Isolates extension conflicts
• Different browser - Identifies browser-specific problems
• Wait 10 minutes - Many issues are temporary

Documentation

In Order of Detail:

1. This Troubleshooting Guide - Quick fixes
2. 5-Minute Quick Start Guide - Basic setup
3. Complete User Guide - Comprehensive reference
4. Technical Settings Guide - Advanced parameters

Community Resources

Where to Look:

• Community forums - Search for similar issues
• AI art communities - Reddit, Discord groups
• Video tutorials - YouTube has many guides
• GitHub issues - For technical problems

Reporting Issues

When to Report:

• Problem persists after trying solutions
• Error messages not in this guide
• Feature completely broken
• Data loss or corruption

What to Include:

1. Browser and version (Chrome 91, Firefox 89, etc.)
2. Operating system (Windows 10, macOS, etc.)
3. Exact error message (copy/paste)
4. Steps to reproduce the problem
5. Screenshots if helpful

Quick Status Check

Is It Just Me?

• Try different browser - If works, it's browser-specific
• Try different device - If works, it's device-specific
• Try different network - If works, it's network-specific
• Ask in community - Others having same issue?

---

Troubleshooting Checklist

Before Asking for Help:

✅ Basic Checks:

• Refreshed page (hard refresh: Ctrl+F5)
• Tried different browser
• Checked internet connection
• Cleared browser cache
• Read relevant section of this guide

✅ Isolation Tests:

• Works in incognito/private mode?
• Works with simple prompt?
• Works with default settings?
• Works in different browser?

✅ Information Gathering:

• Note exact error messages
• Record browser and version
• Document steps that cause problem
• Check if problem is consistent

---

Quick Reference - Common Fixes

---

Remember: 90% of issues are resolved by refreshing the page or trying again. Don't panic if something doesn't work immediately - AI art generation involves many moving parts, and temporary issues are completely normal.

When in doubt: Try the simplest solution first, then work your way up to more complex fixes. Most problems have simple solutions!

Happy troubleshooting! 🛠️