Skip to main content

Publishing vs. Draft Documents

Use draft versions to prepare updates privately before publishing to your team

Ben Gale avatar
Written by Ben Gale
Updated over a week ago

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

  1. Open the document you want to update

  2. Click Upload New Version

  3. Select Draft as the version type

  4. Upload your updated PDF file

  5. 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:

  1. Open the document with the draft

  2. Find the Publish Draft section

  3. 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)

  4. Add a Change Description: Explain what changed (required)

  5. 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:

  1. Review thoroughly: Catch errors before they go live

  2. Get feedback: Share with subject matter experts or leadership

  3. 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:

  1. Monday: Manager uploads a draft of the updated safety policy

  2. Tuesday: Safety officer reviews draft and adds comments suggesting changes

  3. Wednesday: Manager uploads a new draft incorporating the feedback

  4. Thursday: Final review confirms the draft is ready

  5. Friday: Manager publishes the draft as version 2.0 with change description "Updated PPE requirements per new regulations"

  6. 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

Did this answer your question?