Template Versioning
Track changes to your templates with automatic versioning. Revert and manage drafts.
Overview
Document Stack automatically versions your templates every time you save. This gives you a complete history of changes and the ability to revert to any previous version if needed.
Automatic Versioning
Every time you save a template (manually or via auto-save), a new version is created with:
- A version number (v1, v2, v3, ...)
- A timestamp of when the save occurred
- The name of the team member who made the change
- A complete snapshot of the template at that point
Viewing Version History
- Open a template in the editor
- Click Version History in the toolbar (or the clock icon)
- A sidebar panel shows all versions in reverse chronological order
- Click any version to preview it on the canvas
Restoring a Version
- Open the version history panel
- Find the version you want to restore
- Click Restore this version
- Confirm the restoration
Restoring a version creates a new version (e.g., v8 restored from v5). The previous versions remain in the history, so you can always go back.
Draft vs. Published
Templates have two states:
- Draft — Work in progress. Edits are saved but not used by the API.
- Published — The version used when generating PDFs via the API.
This separation means you can make changes to a template without affecting live PDF generation until you're ready to publish.
Publishing a Draft
- Make your changes in the editor
- Preview and verify the template looks correct
- Click Publish in the toolbar
- The current draft becomes the published version
Safe Editing
Always make changes as a draft first and publish only after testing. This prevents broken templates from affecting your production API.Version Limits
| Plan | Versions Kept |
|---|---|
| Free | Last 10 versions |
| Pro | Last 50 versions |
| Enterprise | Unlimited |
When the limit is reached, the oldest versions are automatically removed. The published version is never removed regardless of the limit.
Next Steps
- Editor Overview — Full editor tour
- Template Design Patterns — Best practices for templates
- Canvas & Layers — Navigate the editor canvas