Version Control
Track every change to your prompts with full version history, diff viewing, and rollback capabilities. Deploy with confidence using promotion workflows.
Why Version Control?#
Just like source code, prompts evolve over time. Version control ensures you never lose work, can always understand what changed and why, and can safely experiment without fear of breaking production.
Complete History
Every change is recorded with timestamps, author information, and notes explaining the change.
Diff Viewing
See exactly what changed between any two versions with line-by-line comparison.
Instant Rollback
Revert to any previous version instantly if issues are discovered.
Safe Experimentation
Try new approaches without affecting production—versions are immutable once saved.
Creating Versions#
When you make changes to a prompt, you're working on a draft. To create a new version:
Make your changes
Click "Save Version"
Add version notes
- What was changed
- Why the change was made
- Any testing performed
- References to issues or requests
Assign a label (optional)
Version Note Best Practices
Version States#
Each version exists in one of several states that control how it can be used:
| State | Description | Editable? | Can Promote? |
|---|---|---|---|
| Draft | Unsaved working changes | Yes | No |
| Development | Saved version for active work | No | Yes |
| Staging | Version under testing | No | Yes |
| Production | Live version serving traffic | No | No |
| Archived | Deprecated but preserved | No | No |
Versions move through states via the promotion workflow. Each transition can require approval depending on your team settings.
Comparing Versions#
The diff viewer lets you compare any two versions side-by-side:
Open Version History
Select versions to compare
Review changes
- Added lines (green)
- Removed lines (red)
- Modified lines (highlighted changes)
- Unchanged context lines
Quick Compare
Rollback & Restore#
If you need to revert to a previous version, PromptReports makes it simple:
Find the target version
Click "Restore"
Add restoration notes
Promote if needed
Rollback Creates New Version
Promotion Workflow#
The promotion workflow ensures changes are properly tested before reaching production:
Development → Staging
Staging → Production
Approval Review
Automatic Checks
Learn more about collaboration features including approval workflows in the Collaboration Overview documentation.
Best Practices#
Write Good Notes
Every version should have clear notes explaining the change purpose and any relevant context.
Use Labels
Tag versions with labels like 'stable', 'experimental', 'bugfix' for easy filtering.
Test Before Promoting
Always run evaluations against your test dataset before promoting to higher stages.
Small, Focused Changes
Make incremental changes. Small versions are easier to review, test, and rollback if needed.