Overview
CalmCompliance gives you control over when document updates go live. Published versions are immediately visible to everyone who can access the document. Draft versions let you prepare updates privately, gather feedback, and refine changes before sharing them with your team.
Think of drafts like working on a document behind the scenes—you can take your time, make revisions, and publish only when you're ready.
When to Use Published Versions
Publish a new version directly when:
The changes are ready: The updated document is finalized and reviewed
No collaboration needed: You don't need input from others before publishing
Urgent updates: Time-sensitive corrections or announcements that need to go live immediately
Small corrections: Minor typos or formatting fixes that don't warrant a review process
Published versions immediately become the current version that users see. If the document has an approval workflow, the version is sent for approval before becoming current.
When to Use Draft Versions
Create a draft version when:
You need feedback: You want colleagues to review changes before they go live
Work in progress: You're making updates over several sessions and want to save progress
Approval pending: The document requires formal approval, and you want to prepare everything before triggering the workflow
Testing formatting: You want to check how the new PDF renders before making it official
Draft versions are only visible to users with Manager or Admin roles for the Documents module. Regular users continue to see the current published version until you publish the draft.
How Drafts Work
Creating a Draft
Open the document you want to update
Click Upload New Version
Select Draft as the version type
Upload your updated PDF file
Click Upload (no change description required yet)
The draft is saved but doesn't replace the current published version. Only Managers and Admins can see that a draft exists.
Working with a Draft
While a draft exists:
Users see the current published version - The draft doesn't affect what regular users view
You can replace the draft - Upload a new draft file to update your working version
Collaborators can comment - Share the document with colleagues who have Manager/Admin access to get feedback
Only one draft at a time - You can't create multiple draft versions; you must publish or discard the existing draft first
Publishing a Draft
When your draft is ready to go live:
Open the document with the draft
Find the Publish Draft section
Choose the version type:
Minor Version: For small changes (e.g., 1.0 → 1.1)
Major Version: For significant changes (e.g., 1.0 → 2.0)
Add a Change Description: Explain what changed (required)
Click Publish
If No Approval Workflow
The draft immediately becomes the current published version. Users who follow the document receive notifications about the update.
If Approval Workflow Exists
Instead of publishing directly, the draft is sent to the designated approvers. The draft remains as a draft until approved, then automatically publishes as the new current version.
Common Questions
Can regular users see drafts?
No, only users with the Manager or Admin role for Documents can see that a draft exists. Regular users (with Member access) continue to see the current published version until the draft is published.
How do I know if a document has a draft?
On the document detail page, Managers and Admins will see a Draft Version indicator showing:
When the draft was created
Who created it
A Publish Draft button to make it live
Can I have multiple drafts for one document?
No, you can only have one draft version at a time per document. If you need to make additional changes, you can replace the existing draft by uploading a new draft version, or you can publish the current draft first, then create a new draft.
What happens if I publish a draft but it needs approval?
If the document has an approval workflow assigned, clicking Publish triggers the approval process. The draft is sent to approvers but doesn't immediately become the current version. Once all approvals are complete, the draft automatically publishes.
Can I discard a draft without publishing?
Yes, if you decide not to publish the draft, you can discard it. This removes the draft version and keeps the current published version unchanged.
Do drafts expire?
No, drafts don't expire. They remain until you either publish them or discard them. However, it's good practice not to leave drafts sitting for too long, as it can cause confusion about which version is current.
What if someone else creates a draft while I'm working on one?
Since only one draft can exist at a time, if another Manager/Admin uploads a new draft, it will replace the existing draft. This can cause conflicts, so it's best to coordinate with your team when making updates to important documents.
Best Practices
Use Drafts for Significant Changes
For minor typos or formatting fixes, publishing directly is usually fine. For significant policy changes, procedural updates, or content that affects compliance, use drafts so you can:
Review thoroughly: Catch errors before they go live
Get feedback: Share with subject matter experts or leadership
Time the release: Publish at an appropriate time rather than mid-workflow
Communicate About Drafts
If you create a draft that others need to review, let them know:
"I've uploaded a draft of the updated Fire Safety Policy—please review and comment by Friday."
"Draft version of the Employee Handbook is ready for final approval."
This ensures people know to look for the draft indicator on the document.
Publish Promptly When Ready
Don't leave drafts sitting indefinitely. If the draft is finalized and doesn't need further review, publish it. This keeps your document library current and prevents confusion about which version is official.
Example Workflow
Here's a typical workflow using drafts for a policy update:
Monday: Manager uploads a draft of the updated safety policy
Tuesday: Safety officer reviews draft and adds comments suggesting changes
Wednesday: Manager uploads a new draft incorporating the feedback
Thursday: Final review confirms the draft is ready
Friday: Manager publishes the draft as version 2.0 with change description "Updated PPE requirements per new regulations"
Friday: If approval workflow exists, approvers are notified; if not, version 2.0 goes live immediately
Related Topics
Creating editor documents - Write documents directly in CalmCompliance (editor documents start as drafts)
Document versioning - Learn about version numbers and history
Uploading documents - Upload PDF documents (uploaded PDFs start published)
Creating approval policies - Set up workflows for document approval
Managing review cycles - Keep documents current with scheduled reviews
