laptop, office, hand, writing, business, document, contract, paper, education, work, notebook, data, pen, meeting, recruitment, agreement, paperwork, office, business, business, business, business, business, contract, contract, education, work, meeting, meeting. How to judge policy templates software on version history and attestation
Photo by AymaneJed on Pixabay

Rules

Part of What separates a policy from a standard, a procedure and a guideline?

How to judge policy templates software on version history and attestation

Policy template software: what to check on version history, approval and effective dates, staff search, attestation and export before you commit to any tool.

Policy software does one thing a shared folder cannot: it tells you which version of a document a given person saw, and when. A folder and a spreadsheet can handle everything else badly but adequately.

So decide whether that one thing matters to you, and whether the tool does it well enough to rely on.

No products are named here. The checklist below is organized around the life of a policy: written, approved, published, read, excepted, reviewed, retired. At each stage, what the tool must do, and what a folder does instead.

What to take away

  • The version record is the product. Test whether you can see what version 2 said, who approved it, and who read it, a year later.
  • Attestation counts measure distribution, not compliance; a tool that reports them as compliance is misleading you.
  • An exception register is the most useful feature and the one most tools lack.

Stage by stage

The tool must

Draft
Hold the draft apart from the live version
Approve
Route to the approving role, record who approved what and when
Publish
Separate the approval date from the effective date
Read
Show staff one current version, findable by search, at a stable address
Attest
Record who confirmed reading which version
Except
Keep a register of live exceptions with expiry dates
Review
Remind the owner on a date or a trigger
Retire
Mark withdrawn, keep the archive readable, remove from where staff look

A folder and spreadsheet

Draft
Two files, and someone will open the wrong one
Approve
A row in the spreadsheet, if anyone fills it in
Publish
Possible, if remembered
Read
A folder they never open
Attest
A column that is never complete
Except
A spreadsheet, and the best tools are no better
Review
Calendar reminders
Retire
Move to an archive folder

Test

Draft
Edit the live policy and confirm staff still see the old one
Approve
Approve a test policy and export the approval record
Publish
Set an effective date next month and see when staff see it
Read
Search for a word inside a policy, as a member of staff
Attest
Change the version and see whether attestations reset
Except
Grant a test exception with a three-month expiry
Review
Set a review date and confirm who is notified
Retire
Retire a test policy and try to find it both ways

The version record

This is the reason to buy anything. Test it hard.

Version record checks

  • Every version kept with approval record
  • Readable difference between any two versions
  • Attested version retrievable after staff leave
  • Export of all of it, readable elsewhere

A tool that keeps only the current version, or that overwrites attestations when a policy changes, has removed the one thing it was bought for.

Approval and effective dates

The policy overview explains why approval and effective dates differ: the gap is where communication and training happen.

Approval to effective date

  1. Approval date
    record who approved what
  2. Gap
    communication and training happen
  3. Effective date
    staff see the new version
  4. Switch-over
    check what happens to old version

The tool should hold both dates, show staff nothing until the effective date, and keep the previous version live until then. Check what happens to the old version at switch-over and whether a reader who opened it that morning is told.

Findability

Staff do not browse policy libraries. They search for a word, once, when something has gone wrong. The test is to log in as a member of staff, type a word that appears only in the body of one policy, and see whether it comes up.

Findability test

  1. Log in as a member of staff
  2. Type a word from one policy body
  3. See whether it comes up
  4. Check the address survives a new version

Check that the policy has a stable address that survives a new version. Then a link in a procedure or a training document keeps working.

Search only finds the words people type. That argues for drafting against the federal plain language guidelines, not in a lawyer's register. A policy library and a set of meeting documents share one test: can a reader find the current version a year later?

Attestation

The tool reports the share of staff who clicked to confirm they read a policy. Collect it for the record, but do not report it as compliance. Be wary of a tool whose dashboard does.

Attestation dashboard

Does the tool report clicks as compliance?

Yes

Do not report it as compliance

No

Collect it for the record

The number measures distribution. Signals that measure whether a policy is working, questions reaching the owner, exceptions clustering, and the behavior showing up in a system that already logs it, live outside any policy tool.

One thing worth asking: can the tool ask a reader one question about the policy, rather than one click? A single question answered wrongly by most of the readership is more informative than a full attestation list. A single question still needs a written record, and a policy templates checklist shows what that record must contain.

The exception register

Policies break quietly when there is no exception route.

Exception register fields

  • Approver recorded
  • Scope recorded
  • Expiry date recorded
  • Register points to policies to rewrite

A tool that keeps a register of granted exceptions, each with approver, scope, and expiry, turns that register into a list of policies to rewrite.

Few tools do this well, so if the candidate does not, keep the register in a spreadsheet and have the policy point to it.

Review triggers

A review date is easy. A review trigger, "when the supplier arrangement changes," is not something software can detect. What it can do is remind the owner role, not a named person, and escalate when nobody responds. Check that the reminder goes to a role that changes with the org chart rather than to an inbox that will be closed.

Review date vs trigger

Software can

Remind
Remind the owner role
Escalate
Escalate if no response
Trigger
Date or org chart role

Software cannot

Remind
Detect supplier change
Escalate
Named person inbox
Trigger
External arrangement change

Permissions and audit

Who can edit, who can approve, who can publish, who can only read. Whether a policy can be marked as visible only to certain roles. And an audit export: every action on every policy, by whom, when, in a file you can hand to someone outside the tool. Ask what the export looks like before you need it.

Leaving

Export the whole library, every version, every approval, every attestation, every exception, in a form another tool could read, during the trial. Ask what happens to the archive if you stop paying. Records of who saw which policy when may be needed long after the subscription ends, and the answer to that question should be in writing before you sign.

When a folder is enough

An organization small enough that everyone knows the owner of each policy, and where "did you see version 3?" can be answered by asking, does not need a tool. A folder with one current file per policy, an archive folder, and a spreadsheet of versions, approvals, and review dates will serve.

The tool earns its place when headcount makes asking impossible, when a regulator or customer asks who saw what, or when the exception register outgrows a spreadsheet.

Where policies are read through the procedures that implement them, the operational checklists built from those procedures often give staff the better place to meet the rule.

A trial script

  1. Load three real policies, each with two past versions.
  2. Approve a new version of one with an effective date next week, and log in as staff to see which version shows.
  3. Attest as a staff member, then publish another version, and check what happened to the attestation.
  4. Grant an exception with an expiry.
  5. Search, as staff, for a word from the body of one policy.
  6. Retire one policy. Find it in the archive.
  7. Export everything and open it elsewhere.

Bring the result to whoever chairs the meeting that approves policies. If they cannot read the approval record, neither will an auditor.

Common questions

Does a policy tool replace legal review?
No. Any policy touching employment, personal data, or a regulated activity needs a qualified adviser in your jurisdiction to review the substance. The tool records that it happened; it does not do it.
Is a template library in the tool useful?
For structure, sometimes. The substance of any policy is yours and jurisdiction-specific, and a vendor's template does not know where your staff work.
Should procedures live in the same tool?
Only if the tool handles frequent small edits well. Procedures change with every tool change; policies should not. A system built for one usually fights the other.

More in Rules

Latest from Value Desk