Support & Troubleshooting

Having issues with Image Color Changer? Find solutions to common problems below, or contact our support team for personalized help.

📤 Upload Problems

Issue: "Upload Failed" Error

Possible causes:

File size exceeds 20MB limit
Unsupported file format
Corrupted image file
Network connection issue

Solutions:

Check file size:
- Right-click image → Properties/Get Info
- If >20MB, compress using TinyPNG or similar
- Recommended: Keep images under 10MB for best performance
Verify file format:
- ✅ Supported: JPG, JPEG, PNG
- ❌ Not supported: GIF, BMP, TIFF, WebP, HEIC
- Convert unsupported formats using free tools like CloudConvert
Test with different image:
- Try uploading a different photo to isolate the issue
- If other images work, original file may be corrupted
Check internet connection:
- Ensure stable WiFi/data connection
- Try refreshing the page (F5 or Cmd+R)

Issue: Image Appears Blurry or Low Quality

Cause: Source image resolution is too low

Solutions:

Use higher resolution source:
- Minimum recommended: 1000px width
- Ideal: 2000px+ width for best AI results
- Check image dimensions before uploading
Avoid screenshots:
- Screenshots often have lower quality than original photos
- Use original image files when possible
Export settings:
- If downloading from another site, choose "Original" or "High Quality"
- Avoid "Web Optimized" or "Compressed" versions

Issue: "Image Too Small" Warning

Cause: Image dimensions below minimum threshold (usually <500px)

Solutions:

Use larger source image:
- Find original, uncompressed version
- Avoid thumbnails or preview images
Upscale image (not recommended):
- Use AI upscaling tools like Upscayl
- Note: Upscaled images may still produce lower quality results

🎭 Mask Generation Issues

Issue: AI Doesn't Detect My Object

Possible causes:

Object name too vague or incorrect
Object blends into background
Multiple similar objects in image
Object partially obscured

Solutions:

Be more specific:
- ❌ "shoes" → ✅ "red sneakers on the left"
- ❌ "car" → ✅ "blue sedan hood"
- ❌ "shirt" → ✅ "white t-shirt on person"
Use preset categories:
- Click dropdown → Select object category
- AI will show all detected objects in that category
- Choose the specific one you want
Try manual selection:
- Click "Manual Select" mode
- Draw a rough box around your object
- AI will refine the selection
Improve source image:
- Use photos with clear object separation
- Avoid cluttered backgrounds
- Ensure good lighting and contrast

Issue: Mask Includes Unwanted Areas

Cause: AI over-selected or background is similar to object

Solutions:

Use Eraser Tool:
- Click "Fix Mask"
- Select Eraser Tool (icon: eraser)
- Brush size: 10-20px for edges, 30-100px for large areas
- Click and drag over unwanted selections
- Click "Apply" when done
Adjust detection sensitivity:
- Look for "Sensitivity" slider (if available)
- Lower sensitivity = More conservative selection
- Higher sensitivity = More aggressive selection
Start over with better description:
- Click "Reset Mask"
- Use more specific object name
- Example: "Nike logo on shoe" instead of "logo"

Issue: Mask Misses Parts of Object

Cause: AI under-selected or object has complex edges

Solutions:

Use Brush Tool:
- Click "Fix Mask"
- Select Brush Tool (icon: paintbrush)
- Brush size: 10-20px for fine details, 30-50px for large areas
- Paint over missed areas
- Click "Apply" when done
Increase detection sensitivity:
- Adjust "Sensitivity" slider higher
- Re-generate mask
- May require manual refinement after
For complex edges (hair, lace, etc.):
- Use smallest brush size (10px)
- Zoom in (mouse wheel or pinch)
- Carefully paint along edges
- Be patient - precision takes time!

🎨 Color Application Problems

Issue: Color Looks Unnatural or Flat

Cause: "Preserve Shadows" is disabled, or intensity too high

Solutions:

Enable "Preserve Shadows":
- Look for toggle switch in color panel
- Turn ON (should be default)
- This maintains original lighting and depth
Adjust intensity:
- Try 80-90% instead of 100%
- Allows original texture to show through
- Creates more natural blend
Check source image lighting:
- Flat lighting in source = Flat result
- Use well-lit photos with visible shadows/highlights
- Avoid overexposed or underexposed images

Issue: Color Doesn't Match My Brand Color Exactly

Cause: Using AI Magic instead of Precision Mask, or color space differences

Solutions:

Switch to Precision Mask mode:
- AI Magic interprets colors creatively
- Precision Mask applies exact hex codes
- Learn Precision Mask →
Use hex code input:
- Click color picker
- Find hex input field (e.g., #FF5733)
- Paste your exact brand color code
- Press Enter to apply
Check color profile:
- Download result
- Open in photo editor (Photoshop, GIMP)
- Verify color values match
- If off, may be browser color management issue
Test on different devices:
- Colors may appear different on various screens
- Use calibrated monitor for color-critical work
- Consider sRGB color space for web consistency

Issue: Color Bleeds Outside Object

Cause: Mask edges are too soft or imprecise

Solutions:

Refine mask edges:
- Click "Fix Mask"
- Use Eraser Tool to clean up edges
- Zoom in for precision work
- Focus on border areas
Use higher resolution source:
- Low-res images have less defined edges
- Upscale or use original high-res version

✨ AI Magic Issues

Issue: AI Result Doesn't Match My Prompt

Cause: Prompt too vague, or AI misinterpreted intent

Solutions:

Make prompt more specific:
- ❌ "gold" → ✅ "metallic rose gold with brushed finish"
- ❌ "shiny blue" → ✅ "glossy midnight blue with reflections"
- Include material, color, AND finish
- See Prompt Writing Guide →
Try alternative phrasing:
- "chrome mirror finish" vs. "reflective silver metal"
- "matte black leather" vs. "soft black leather texture"
- Small word changes can produce different results
Iterate with variations:
- Generate 2-3 versions with slightly different prompts
- Compare results
- Refine based on what works best
Check example prompts:
- AI Magic Use Cases →
- Copy proven prompt structures
- Adapt to your specific needs

Issue: AI Result Looks Unrealistic

Cause: Prompt conflicts with object context, or source image quality issues

Solutions:

Match prompt to object type:
- Don't apply "leather texture" to metal objects
- Don't use "fabric" prompts on hard surfaces
- AI works best when prompt aligns with object material
Simplify prompt:
- Remove conflicting descriptors
- Focus on one material/finish
- Example: "glossy metallic gold" instead of "glossy matte metallic gold"
Reduce intensity:
- Lower to 60-80%
- Blends AI result with original
- Creates more subtle, believable effect
Use better source image:
- Well-lit, sharp, high-resolution
- Clear object details visible
- Minimal noise or compression artifacts

Issue: AI Processing Takes Too Long

Cause: Large image size, server load, or network issues

Solutions:

Check file size:
- Right-click image → Properties/Get Info
- If >20MB, compress using TinyPNG or similar
- Recommended: Keep images under 10MB for best performance
Verify file format:
- Ensure it's JPG or PNG (not TIFF, BMP, etc.)
- Convert if necessary
Reduce image size:
- Resize to 2000px width (optimal balance)
- Compress before uploading
- Smaller files = Faster processing
Check processing time estimates:
- Small (<1MB): 10-15 seconds
- Medium (1-5MB): 15-25 seconds
- Large (5-20MB): 25-40 seconds
- If exceeding these, may be server issue
Refresh and retry:
- If stuck >60 seconds, refresh page
- Re-upload and try again
- May have been temporary server hiccup
Try during off-peak hours:
- Server load varies by time of day
- Early morning or late evening often faster
- Weekdays typically faster than weekends

Issue: "AI Generation Failed" Error

Cause: Server error, prompt issue, or image incompatibility

Solutions:

Simplify prompt:
- Remove special characters or emojis
- Use plain English
- Avoid very long prompts (>50 words)
Check image:
- Try different source image
- Ensure image isn't corrupted
- Verify format is JPG or PNG
Retry generation:
- Click "Generate" again
- May have been temporary server issue
- If fails 3+ times, contact support
Clear browser cache:
- Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
- Select "Cached images and files"
- Click "Clear data"
- Refresh page and try again

💾 Download & Export Issues

Issue: Download Button Doesn't Work

Cause: Browser popup blocker, or JavaScript error

Solutions:

Check popup blocker:
- Look for blocked popup icon in address bar
- Click and select "Always allow popups from this site"
- Try download again
Try different browser:
- Test in Chrome, Firefox, Safari, or Edge
- Some browsers have stricter security settings
- Use latest browser version
Right-click alternative:
- Right-click on the result image
- Select "Save Image As..."
- Choose location and save
Clear browser cache:
- May be JavaScript conflict
- Clear cache and cookies
- Refresh page and try again

Issue: Downloaded Image is Low Quality

Cause: Wrong quality setting selected, or browser compression

Solutions:

Default is PNG:
- The app exports in PNG format to preserve transparency and quality
- File size may be larger than JPG, but quality is better
Use online converter:
- If you strictly need JPG
- Use free tools like CloudConvert or Squoosh
Check original image quality:
- Downloaded result can't exceed source quality
- If source is low-res, result will be too
- Use high-quality source images
Disable browser image compression:
- Some browsers compress downloads
- Check browser settings → Downloads
- Disable any "Optimize downloads" options

Issue: Downloaded Image Has Wrong Format

Cause: Browser auto-converted format, or wrong selection

Solutions:

Verify format:
- The download button automatically saves as high-quality PNG
- This ensures the best quality for your edited image
Rename file extension:
- If downloaded as .jpg but you wanted .png
- Right-click file → Rename
- Change extension (may need to show file extensions in OS)
Use "Save As" method:
- Right-click result image
- "Save Image As..."
- Manually type filename with correct extension

🖥️ Performance & Browser Issues

Issue: App is Slow or Laggy

Cause: Browser performance, large image, or too many browser tabs

Solutions:

Close unnecessary tabs:
- Each tab uses memory
- Close other tabs to free resources
- Restart browser if needed
Use recommended browsers:
- ✅ Chrome 90+
- ✅ Firefox 88+
- ✅ Safari 14+
- ✅ Edge 90+
- Update to latest version
Reduce image size:
- Resize to 2000px width before uploading
- Compress with tools like TinyPNG
- Smaller images = Better performance
Clear browser cache:
- Old cached files can slow performance
- Clear cache and cookies
- Restart browser
Check system resources:
- Close other applications
- Ensure sufficient RAM available (4GB+ recommended)
- Restart computer if needed

Issue: Interface Elements Not Displaying Correctly

Cause: Browser compatibility, zoom level, or CSS loading issue

Solutions:

Reset browser zoom:
- Press Ctrl+0 (Windows) or Cmd+0 (Mac)
- Ensures 100% zoom level
- Interface designed for 100% zoom
Try different browser:
- Test in Chrome, Firefox, or Edge
- May be browser-specific rendering issue
Disable browser extensions:
- Ad blockers or privacy extensions may interfere
- Temporarily disable extensions
- Refresh page and test
Clear cache and hard reload:
- Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
- Forces fresh CSS/JS download
- May fix display issues

Issue: Mobile App Not Working Properly

Cause: Mobile browser limitations, or responsive design issue

Solutions:

Use supported mobile browsers:
- ✅ Chrome (Android)
- ✅ Safari (iOS)
- ✅ Firefox (Android/iOS)
- Update to latest version
Rotate to landscape:
- Some features work better in landscape mode
- Provides more screen space for editing
Use desktop mode (if needed):
- In mobile browser, request "Desktop Site"
- May provide full functionality
- Note: Interface may be harder to use
Consider using desktop:
- For complex editing, desktop is recommended
- Mobile is best for quick, simple recolors
- Desktop provides full feature set

💳 Account & Billing

Solutions:

Reset password:
- Click "Forgot Password" on login page
- Enter your email address
- Check inbox for reset link (check spam folder)
- Follow link to create new password
Check email address:
- Ensure you're using correct email
- Try alternative email addresses you may have used
- Check for typos
Clear browser cookies:
- Cookies may be preventing login
- Clear cookies for this site
- Try logging in again
Contact support:
- If still can't access account
- Email support with registered email
- We'll help recover your account

Issue: Credits Not Updating After Purchase

Cause: Payment processing delay, or cache issue

Solutions:

Wait 5-10 minutes:
- Payment processing can take time
- Refresh page after waiting
- Check credit balance again
Check payment confirmation:
- Verify payment was successful
- Check email for receipt
- Check bank/card statement
Log out and back in:
- Click "Log Out"
- Log back in
- Forces account data refresh
Contact support with receipt:
- Email support
- Include payment receipt/transaction ID
- We'll manually credit your account

Issue: Subscription Not Working

Cause: Payment failed, or subscription not activated

Solutions:

Check subscription status:
- Go to Account → Subscriptions
- Verify status is "Active"
- Check renewal date
Verify payment method:
- Ensure card hasn't expired
- Check for sufficient funds
- Update payment method if needed
Check email for notifications:
- Look for payment failure emails
- May need to update billing info
Contact support:
- Email support with account email
- We'll investigate subscription status
- Can manually activate if needed