Skip to main content

Document Versioning

Manage document versions with semantic versioning, change descriptions, and complete history

Written by Ben Gale
Updated over 2 weeks ago

Why Document Versioning

Versioning keeps a complete history of every change to your documents. When you update a procedure, fix a typo, or revise a policy, CalmCompliance creates a new version while preserving the old one—so you can see what changed, when, and by whom. That matters for compliance auditing and institutional knowledge. Users always see the current published version by default, but you can access the full history whenever needed.

Understanding Version Numbers

  • Minor versions (e.g. 1.0 → 1.1): Small changes—typos, clarifications—that don't fundamentally change the document. Does not trigger automatic redistribution.

  • Major versions (e.g. 1.0 → 2.0): Significant updates, policy changes, or rewrites. Triggers redistribution if configured.

Note: PDF documents support major versions only—each new upload increments the major version. Editor documents let you choose minor or major when publishing.

How to Add a New Version (PDF)

  1. Open the document you want to update

  2. Click Upload New Version (in the document actions menu)

  3. Click Choose File and select your updated PDF

  4. Add a Change Description: Explain what changed so others understand the update

  5. Click Upload

The new version becomes the current major version immediately. The previous version stays in the document's history. PDF documents do not have draft states—each upload publishes as a new version.

How to Add a New Version (Editor Document)

  1. Open the published document

  2. Click Create Draft Version or Edit

  3. Make your changes in the editor

  4. Click Publish Draft when ready

  5. Choose Minor Version (small changes) or Major Version (significant changes)

  6. Add a Change Description and click Publish

If an approval workflow is assigned, publishing triggers that process. Otherwise the new version goes live immediately.

How to View Version History

  1. Open any document

  2. Open the Versions tab or Version History section

  3. You'll see all published versions with version number, date, who uploaded it, and change description

Click any version to view that revision. Useful for understanding how a document evolved or retrieving previous policy language.

Before You Start

You need the Manager role for the Documents module. If you don't see Upload New Version or Create Draft Version, ask your site administrator to update your permissions in Settings > User Management > Edit Access.

Common Questions

What happens to the old version when I add a new one? Nothing is deleted. The old version remains in history. Users see the new version by default, but you can always access previous versions.

Should I choose minor or major for most updates? Use minor for corrections and small updates. Use major when changes are significant enough that users should be aware—e.g. a new safety requirement or updated procedure.

Can I delete a version? No. Version history is permanent for audit trails. If you uploaded the wrong file, upload another version immediately with the correct file.

Can I have more than one draft? No. You can only have one draft at a time. Publish or discard the existing draft before creating a new one.

Did this answer your question?