Understanding document version numbers

Understanding document version numbers

Xoralia helps document owners keep track of their document versions. In particular, when a user attests to reading a document the document name and version number is logged (as is the time and date of the attestation).

When managing controlled documents such as policies, owners typically want to keep old versions of those documents so that they can refer back to them. To help them keep track of changes owners often use version numbers. For example, if an important new paragraph is added to a policy then the owner might change the version number from say, 1.5 to 1.6. If a policy is completely re-written, this would count as a major version, and so the owner changes the version number to 2.0. However, if a document owner merely fixes a typo or other small error in a document, they may not want to create a new version at all.

A useful feature of SharePoint is that document libraries can automatically keep track of document versions and allow access to those versions and the ability to roll-back to a previous version. To do this, version control needs to be switched on for that document library. Whilst automation like this is very useful it does have a downside: new versions are created all the time, including if small insignificant changes are made such as fixing a typo or changing formatting.

To overcome this issue document owners maintain two sets of version numbers – the ones that SharePoint automatically creates, and one which is changed manually by the owner. The manual one is simply a metadata column inside the SharePoint document library. It can be a simple number, a date, or any text that the owner wants to use. The important thing to recognise is that inside the Xoralia document library view, the version number displayed is the manual version number. This is also the one that is logged by the system.

When to use Xoralia and when to use SharePoint

When to use Xoralia and when to use SharePoint

When Xoralia is associated with one or more document libraries in your SharePoint you can carry out most common tasks inside the user-friendly Xoralia interface. However, some tasks can’t be done in Xoralia or are best done in SharePoint.

The table below outlines typical document management tasks that a document owner might carry out, and indicates whether it can be done inside Xoralia or SharePoint (or both). Some of these may change as we improve Xoralia, allowing you to do more from within the Xoralia interface.

Task Can be done in Xoralia? Can be done in SharePoint? Can be done using PowerAutomate?
Requesting to create a new document No No Yes
Adding or creating new documents in a document library No Yes Yes
Reviewing existing documents (i.e. making changes to a doc) when there is no workflow associated with a document No Yes No
Reviewing existing documents (i.e. making changes to a doc) when there is workflow associated with a document No Yes Yes
Automate document workflow tasks such as approving document changes, requesting approval from a manager etc. No No Yes
Changing the expiry date on a document Yes No Yes
Adding or changing metadata properties of a document (e.g. document owner, tags, version number etc.) No, except expiry date Yes No
Managing version numbers (note that there are two types of version numbers – for more information on this, see Understanding policy version numbers) No Yes Yes
Rolling back to a previous version of a document No Yes No
Archiving old documents that are no longer needed No Yes Yes
Assigning a document for users to read and asking them to attest to having read it Yes No No
Viewing reports and analytics on who has and who hasn’t attested to reading a document Yes No No

The table below outlines typical tasks that an end user (e.g. an employee who is not a document owner) might carry out, and indicates whether it can be done inside Xoralia or SharePoint (or both):

Task Can be done in Xoralia? Can be done in SharePoint?
Searching for a document Yes Yes
Reading a document Yes Yes
Reading an assigned document and attesting to having read it Yes No
Viewing document read tasks that have been assigned to me Yes No
Checking which assigned documents I have read and haven’t read Yes No

Document reviews and expiry

Document reviews and expiries

In most policy management scenarios, policy owners have to review their policies (normally annually) to ensure that they are still relevant and in line with best practice.

Documents due for review

Xoralia helps document owners to stay on top of these review tasks by showing a ‘Due for review’ flag inside Xoralia and also by sending reminder notifications when policies are reaching expiry. Notifications are sent 30, 15, 7, 3, 2, 1 and 0 days before expiry. A final notification is sent the day after expiry. The system sends out notifications once a day. The notification contains instructions explaining what the document owner needs to do to reset the expiry date and prevent the document from expiring.

In a simple scenario, a document owner might merely read the document and make changes as appropriate as part of the review. In a more complex scenario, a review could trigger a workflow which might include document changes by the owner, a review of those changes by colleagues, and then a final approval by a line manager. In either scenario, these actions would be carried out in Word Online or SharePoint. Nothing happens in Xoralia until the review has taken place. In fact, the current live version of the document would stay in place and users can continue to attest to have read the document. Once all review steps have happened, the document owner simply goes to the document in Xoralia and changes the expiry date to a suitable date. This action, providing the expiry date is set to more than 30 days out, will take the document out of the ‘Due for review’ state. No further notifications will be sent and the ‘Due for review’ flag will disappear.

Documents that have expired

If a document is allowed to go past its expiry date then a red ‘Expired’ flag will show next to the document. This will be visible by all users. The document can still be viewed and any assignments can still take place. A key difference with expired documents is that any users who have attestation assignments against that document will also see a large red warning sign telling them that the document has expired. Users may therefore decide not to attest to a document but instead contact the owner to see if a document update is imminent. Document owners should avoid letting documents expire as this could affect the confidence that users have in the content of the document. A further risk is that users feel that they can ignore their mandatory read tasks.

How to take a document out of its expired state

The action for removing a document out of its expired state is identical as taking out of the review state described above. Also as above, any document changes or workflows would happen inside Word Online or SharePoint. All Xoralia needs is a new expiry date in order to reset the document to an ordinary state.

Download user guide: Document reviews and expiry

Webinar video: Using SharePoint for policy management and compliance

Webinar video: Using SharePoint for policy management and compliance




Ensuring that employees read policies is an important factor in compliance for all organisations. You may be considering using SharePoint to manage your policies or your organization may be using it now, but in either case you may be asking the question ‘Is SharePoint the best approach?

During this webinar, we will show you how to get the most out of SharePoint when managing your policies and help your organisation to stay compliant.

We will explain why SharePoint is the best approach and cover:

  • Common organisational scenarios in policy management
  • How to get the best out of SharePoint
  • Is SharePoint enough?
  • One of our customer case studies

Book a live demo

Find out more about Xoralia policy management software

During the demo, we'll walk you through Xoralia’s various features and functionality, providing plenty of time for you to ask our experts questions along the way.

Book a demo
PHP Code Snippets Powered By : XYZScripts.com

We use cookies to give you the best experience on our site. By continuing to use our website, you are agreeing to our use of cookies. To find more about the cookies, please see our Cookie notice

You can also read about our Privacy policy

Contact Support

If you have a question about Xoralia software, please fill out the form below and a member of our support team will be in contact with you shortly.