> For the complete documentation index, see [llms.txt](https://docs.meganova.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meganova.ai/character-studio/reference/troubleshooting.md).

# Troubleshooting

> **Note:** Solutions to common issues in Character Studio. Find your problem and follow the steps to resolve it.

## Character Issues

### Character Not Responding

**Symptoms:**

* Chat messages don't get responses
* Spinning indicator never stops
* Error messages appear

**Solutions:**

1. **Check credit balance**
   * View credits in header
   * Purchase more if depleted
2. **Check network connection**
   * Refresh the page
   * Check internet connectivity
3. **Try a different model**
   * Some models may be temporarily unavailable
   * Switch to an alternative in settings
4. **Start a new session**
   * Click "New Chat"
   * Previous session may be corrupted

### Character Acting Out of Character

**Symptoms:**

* Responses don't match personality
* Character forgets who they are
* Inconsistent behavior

**Solutions:**

1. **Check character definition**
   * Review personality and description
   * Ensure key traits are clearly stated
2. **Add more examples**
   * Include dialogue examples
   * Show specific behaviors
3. **Start fresh session**
   * Old context may be confusing
   * Begin new conversation
4. **Reduce context size**
   * Very long conversations lose early context
   * Important info should be in definition

### Character "Forgets" Information

**Symptoms:**

* Previously mentioned facts forgotten
* Character asks about things already discussed

**Solutions:**

1. **Use pinned memories**
   * Pin important facts
   * They persist across context trimming
2. **Include in character definition**
   * Core information belongs in definition
   * Not relying on conversation memory
3. **Use lorebook entries**
   * Important world info in lorebook
   * Triggered by keywords

## Chat Issues

### Messages Not Sending

**Symptoms:**

* Send button doesn't work
* Messages disappear
* Error after sending

**Solutions:**

1. **Check for empty message**
   * Message must contain text
   * Whitespace-only won't send
2. **Refresh the page**
   * Temporary glitch
   * Try again after refresh
3. **Check character status**
   * Character must be saved
   * Unsaved changes may cause issues

### Streaming Stops Mid-Response

**Symptoms:**

* Response cuts off unexpectedly
* Partial messages displayed
* Loading indicator disappears early

**Solutions:**

1. **Network issues**
   * Check internet connection
   * Retry the message
2. **Model limits**
   * Response hit max token limit
   * Increase max tokens in settings
3. **Context window full**
   * Start new session
   * Reduce character definition size

### Slow Responses

**Symptoms:**

* Long wait before response starts
* Typing indicator for extended time

**Solutions:**

1. **Try a faster model**
   * Some models are slower
   * Economy models often faster
2. **Reduce context**
   * Shorter conversations are faster
   * Trim character definition
3. **Check server status**
   * May be high demand
   * Try again later

## Image Issues

### Image Generation Fails

**Symptoms:**

* Error message after generation request
* Image never appears
* Loading never completes

**Solutions:**

1. **Check credits**
   * Image generation requires credits
   * Ensure sufficient balance
2. **Simplify prompt**
   * Complex prompts may fail
   * Try shorter description
3. **Try different model**
   * Some image models may be unavailable
   * Switch to alternative

### Image Upload Fails

**Symptoms:**

* Upload button doesn't respond
* Error after selecting file
* Image doesn't appear

**Solutions:**

1. **Check file size**
   * Maximum 1MB recommended
   * Compress larger images
2. **Check file format**
   * PNG, JPEG, WebP supported
   * Convert other formats
3. **Check storage quota**
   * May be at storage limit
   * Delete unused images

### Avatar Not Displaying

**Symptoms:**

* Blank avatar in chat
* Broken image icon
* Default avatar shown

**Solutions:**

1. **Re-upload avatar**
   * Original may be corrupted
   * Upload fresh copy
2. **Clear browser cache**
   * Cached bad version
   * Hard refresh (Ctrl+Shift+R)
3. **Check image URL**
   * Image may have been deleted
   * Upload new avatar

## Import/Export Issues

### PNG Card Import Fails

**Symptoms:**

* "Invalid card" error
* Character not recognized
* Data missing after import

**Solutions:**

1. **Verify it's a character card**
   * Must have embedded data
   * Regular PNGs won't work
2. **Check card version**
   * CCv2 and CCv3 supported
   * Very old formats may not work
3. **Try JSON export instead**
   * Get JSON from source
   * Import as JSON file

### Export Creates Empty Card

**Symptoms:**

* Downloaded PNG has no data
* Re-import fails
* File seems corrupted

**Solutions:**

1. **Save character first**
   * Export requires saved data
   * Save before exporting
2. **Check avatar**
   * Avatar required for PNG export
   * Add avatar if missing
3. **Try JSON export**
   * Alternative format
   * May work when PNG fails

## Account Issues

### Can't Log In

**Symptoms:**

* Login fails
* Error messages
* Redirected to login repeatedly

**Solutions:**

1. **Check credentials**
   * Verify email/password
   * Use password reset if needed
2. **Clear browser data**
   * Clear cookies for site
   * Try fresh browser session
3. **Check browser**
   * Try different browser
   * Disable extensions temporarily

### Credits Not Showing

**Symptoms:**

* Balance shows wrong amount
* Recent purchase missing
* Credits not updating

**Solutions:**

1. **Refresh the page**
   * May be cached data
   * Hard refresh (Ctrl+Shift+R)
2. **Wait a moment**
   * Processing may take time
   * Check again in a few minutes
3. **Check email confirmation**
   * Verify purchase completed
   * Contact support if payment made but credits missing

## Browser Issues

### Page Not Loading

**Symptoms:**

* Blank page
* Endless loading
* Error messages

**Solutions:**

1. **Check browser compatibility**
   * Use modern browser (Chrome, Firefox, Safari, Edge)
   * Update to latest version
2. **Disable extensions**
   * Ad blockers may interfere
   * Try incognito/private mode
3. **Clear cache**
   * Old cached files
   * Clear site data

### Features Not Working

**Symptoms:**

* Buttons don't respond
* Features missing
* JavaScript errors

**Solutions:**

1. **Enable JavaScript**
   * Required for functionality
   * Check browser settings
2. **Update browser**
   * Old browsers may lack features
   * Use latest version
3. **Check console for errors**
   * Open Developer Tools (F12)
   * Look for error messages

## Performance Issues

### Application Running Slow

**Symptoms:**

* Laggy interface
* Delayed responses
* Freezing

**Solutions:**

1. **Close other tabs**
   * Free up browser memory
   * Close unnecessary tabs
2. **Reduce conversation length**
   * Very long chats slow down
   * Start fresh session
3. **Clear browser cache**
   * Accumulated data slows things
   * Clear site data

### High Memory Usage

**Symptoms:**

* Browser using lots of RAM
* System slowdown
* Crashes

**Solutions:**

1. **Refresh the page**
   * Clears memory
   * Start fresh
2. **Close unused features**
   * Multiple open editors
   * Close what you're not using
3. **Restart browser**
   * Complete memory reset
   * Reopen Character Studio

## Getting More Help

If these solutions don't resolve your issue:

1. **Check FAQ** — [FAQ](https://docs.meganova.ai/character-studio/reference/faq.md)
2. **Search documentation** — Your issue may be covered elsewhere
3. **Contact support** — Provide details about the issue

### When Contacting Support

Include:

* What you were trying to do
* What happened instead
* Error messages (if any)
* Browser and version
* Steps to reproduce

## See Also

* [FAQ](https://docs.meganova.ai/character-studio/reference/faq.md) — Frequently asked questions
* [Glossary](https://docs.meganova.ai/character-studio/reference/glossary.md) — Term definitions
* [Getting Started](https://docs.meganova.ai/character-studio/getting-started.md) — Basic guides
