Having trouble with a game upload? This guide covers the most common issues and how to resolve them.

## Common Errors

### "No file provided"

**Cause:** The upload form was submitted without selecting a file.

**Fix:** Click **Browse** to select a file before clicking **Import**.

### "Unknown codec key"

**Cause:** The notation format you selected doesn't match any registered codec.

**Fix:** Make sure you selected the correct game first. The notation format dropdown only shows formats compatible with the selected game. If no formats are available, the game may not support uploads yet — check [Supported Formats](/docs/2-supported-formats).

### "No plays found in uploaded file"

**Cause:** The file was parsed but didn't contain any recognizable game records.

**Fix:**
- Verify the file isn't empty
- Make sure you selected the correct notation format for your file
- For PokerStars files, ensure the hand history starts with "PokerStars Hand #"
- Open the file in a text editor to confirm it contains valid game data

### "GNv1 validation failed"

**Cause:** The file was parsed but the resulting game data didn't pass our validation checks.

**Fix:**
- The file may contain a game variant we don't support yet (e.g., Zoom poker, PLO)
- The hand history may be in a non-English language
- The file may be corrupt or truncated — try re-exporting from the source

### "Import processing failed"

**Cause:** A server-side error occurred during processing.

**Fix:**
- Try uploading the file again — transient errors are automatically retried
- If the error persists, the file may contain data our parser can't handle

### Some plays succeeded, some failed

**Cause:** In a multi-hand file, individual hands may have parsing issues while others are fine.

**Fix:**
- This is normal — we process each hand independently
- Check the import results table for specific error messages on failed plays
- Successfully imported plays are available in your library regardless of other failures

## File Format Tips

### PokerStars

- Export hand histories in **English** (other languages aren't supported yet)
- Use the standard `.txt` export format
- Files can contain any number of hands
- Make sure the file hasn't been modified or reformatted after export

### Tic-Tac-Toe

- Each file should contain exactly one game
- Use the `Key: Value` format documented in [Supported Formats](/docs/2-supported-formats)
- Cell indices must be 0-8

## Reporting Issues

If you believe your file should work but keeps failing:

1. Note the error message from the import results
2. Check if your file matches one of our [supported formats](/docs/2-supported-formats)
3. Email **support@mieza.ai** with:
   - The error message
   - The game and notation format you selected
   - The file (if you're comfortable sharing it — we treat all uploads as confidential)

We review every report and use them to improve our parsers.

## Performance Notes

- **Upload size:** Files up to 10 MB are supported
- **Processing time:** Typically 1-2 seconds per hand for parsing, plus solver time for analysis
- **Concurrent uploads:** You can start a new upload while a previous one is still processing