> 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/character-features/character-versions.md).

# Character Versions

> **Note:** Character versioning automatically tracks changes to your characters, allowing you to view history and rollback to previous states.

## Overview

Character Studio's versioning system:

* **Auto-saves** a new version on every save
* **Preserves** complete character snapshots
* **Enables** rollback to any previous version
* **Tracks** change history over time

## How Versioning Works

### Automatic Version Creation

Every time you save a character:

1. Current state is captured as a snapshot
2. New version number is assigned
3. Timestamp is recorded
4. Previous version remains accessible

### Version Contents

Each version stores:

* All character fields (name, description, personality, etc.)
* Avatar reference
* Settings and configuration
* Attached lorebook references
* Timestamp and optional notes

## Accessing Version History

1. Open a character in Character Studio
2. Click the **Versions** tab
3. View the version timeline

## Version Timeline

The version timeline shows:

| Column      | Description                    |
| ----------- | ------------------------------ |
| **Version** | Version number (v1, v2, v3...) |
| **Date**    | When the version was saved     |
| **Notes**   | Optional change description    |
| **Actions** | View, Compare, Rollback        |

## Working with Versions

### Viewing a Version

1. Click **View** on any version
2. See the character as it was at that point
3. Review all fields in read-only mode

### Comparing Versions

1. Select two versions to compare
2. Click **Compare**
3. See a diff view highlighting changes

### Rolling Back

To restore a previous version:

1. Find the version you want
2. Click **Rollback**
3. Confirm the action
4. Character reverts to that state
5. A new version is created with the rollback

> **Note:** Rollback creates a new version with the old content. No versions are deleted.

## Adding Change Notes

Document your changes:

1. Before saving, click **Add Notes** (if available)
2. Enter a brief description
3. Save the character
4. Notes appear in version history

**Good change notes:**

* "Added backstory about childhood"
* "Fixed inconsistent personality traits"
* "Updated dialogue examples for new speech pattern"

## Version Limits

| Tier       | Versions Retained |
| ---------- | ----------------- |
| Free       | 10 most recent    |
| Pro        | Unlimited         |
| Enterprise | Unlimited         |

When the limit is reached, oldest versions are automatically removed.

## Best Practices

### 1. Save Before Major Changes

Create a checkpoint before significant edits.

### 2. Use Meaningful Notes

Document what changed and why for future reference.

### 3. Review Before Rollback

View the target version to ensure it's what you want.

### 4. Don't Rely Solely on Versions

Export important characters as backups.

## Use Cases

### Experimentation

1. Save current state
2. Make experimental changes
3. Test the character
4. Rollback if the experiment fails

### Collaboration

1. Team member makes changes
2. Another reviews via version history
3. Rollback if changes aren't approved

### Recovery

1. Accidental deletion of content
2. Find version with original content
3. Rollback to restore

## Technical Details

### Storage

Versions are stored server-side as complete snapshots (not diffs).

### Performance

* Version list loads quickly
* Full version details load on-demand
* Rollback is immediate

### Data Integrity

* Versions are immutable once created
* Rollback creates new versions, preserving history

## Troubleshooting

### Versions not appearing

* Ensure you clicked **Save** (auto-draft doesn't create versions)
* Check the Versions tab is loaded
* Refresh the page

### Can't rollback

* Verify you have edit permissions
* Check if the character is locked
* Ensure the target version exists

### Missing older versions

* Free tier only retains 10 versions
* Upgrade to Pro for unlimited history

## See Also

* [Blueprint Editor](https://docs.meganova.ai/character-studio/creation-modes/blueprint-editor.md) — Where changes are made
* [Import & Export](https://docs.meganova.ai/character-studio/import-export.md) — External backup options
* [Troubleshooting](https://docs.meganova.ai/character-studio/reference/troubleshooting.md) — Common issues
