Skip to main content

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:

1

Make your changes

Edit your prompt in the editor. Changes are auto-saved as a draft.
2

Click "Save Version"

When ready, click the "Save Version" button to create an immutable snapshot.
3

Add version notes

Write a description of what changed and why. Good notes include:
  • What was changed
  • Why the change was made
  • Any testing performed
  • References to issues or requests
4

Assign a label (optional)

Add labels like "stable", "experiment", or custom tags for organization.

Version States#

Each version exists in one of several states that control how it can be used:

StateDescriptionEditable?Can Promote?
DraftUnsaved working changesYesNo
DevelopmentSaved version for active workNoYes
StagingVersion under testingNoYes
ProductionLive version serving trafficNoNo
ArchivedDeprecated but preservedNoNo

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:

1

Open Version History

Click the "History" tab or icon to view all versions.
2

Select versions to compare

Choose a "base" version (older) and a "compare" version (newer).
3

Review changes

The diff view shows:
  • Added lines (green)
  • Removed lines (red)
  • Modified lines (highlighted changes)
  • Unchanged context lines

Rollback & Restore#

If you need to revert to a previous version, PromptReports makes it simple:

1

Find the target version

Navigate to the version you want to restore in the version history.
2

Click "Restore"

This creates a new version with the content of the selected version.
3

Add restoration notes

Document why the rollback was necessary.
4

Promote if needed

If rolling back production, promote the restored version through your workflow.

Promotion Workflow#

The promotion workflow ensures changes are properly tested before reaching production:

1

Development → Staging

Request promotion when ready for broader testing. Run evaluations against test datasets.
2

Staging → Production

After validation, request production promotion. This triggers approval workflows and regression tests.
3

Approval Review

Designated approvers review the changes, evaluation results, and decide to approve or request changes.
4

Automatic Checks

If configured, regression tests run automatically. Promotions are blocked if quality drops below threshold.

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.