Choosing your Version Strategy

qc r&u byline current version

By using the QC Read & Understood for Confluence Cloud app, the user gets to choose the page version strategy.


There are three strategies to choose:

  1. based on the built-in Confluence page version control
  2. based on QC Revision Value, and
  3. based on the page property macro.

The chosen strategy will apply in all of your pages within the Space.


Based on Confluence page version control

This option does not require any more configuration. Users can just start to review pages and R&U their content.

The native Confluence page version number will be tracked by the app.


Based on QC Revision Value

The based on QC Revision Value versioning option combines the use of both the QC Read & Understood and the QC Documents apps. So, in order to use it, you have to have installed the QC Documents app first.

How to use based on QC Revision Value version strategy

When choosing this versioning option, make sure you have assigned QC Revision Value to your pages via the QC Page Revision Overview.

The steps to use it are simple:

  1. Install the QC Documents app
  2. Go to the QC Page Revision Overview
  3. Assign QC Revision Value
  4. Done!

If you want to learn more about how to assign QC Revision Value to your document pages, click here and read the article.


Based on Page Property macro

The Page Property macro can be used so you can keep track of your page version.


Learn how to use the “Based on Page Property macro” version strategy by watching the following tutorial video or keep reading this article.



Adding the Page Property to your page


The Page Properties macro uses key/value pairs.


To add the Page Properties macro to a page:

  1. In the editor, choose Insert > Other Macros > Page Properties.
  2. In the macro body create a two-column table.
  3. In the left column, list your keys, these will be the column headings in your report table.
  4. In the right column, list the value for each key, these will populate the rows in your report table.
  5. Save your page.

Always use the Page Properties Macro horizontally.


Here’s how the macro looks on your page:

page properties macro diplayed

Setting up the parameters


Back to the Space Settings page

In this page we define:

  1. The page property ID, this is optional in case you have more than 1 page property macros within your pages.
  2. The page property header, this is mandatory in order for the page property macro to work.
  3. The version format.


The Version format field , will allow you to define two things:

  1. how many numbers your version would have [3 (Major.Minor.Revision), 2 (Major.Minor), 1 (Major)]. This could be useful, if you decide that the page version will have, in our case, 3 version numbers i.e. Major.Minor.Revision (such as 3.5.4) where:
    • Major number, to be increased when there are changes to a document that require the document to be re-approved(either by an individual or a group)
    • Minor number, to be increased whenever there are minor document amendments, and
    • Revision number, to be increased whenever there are spelling or grammar corrections,
  2. for which numbers the users would require to re-confirm that they have read and understood the page.

The field gives the user the following options:

  • Major.Minor.Revision
    • The user will require to re-confirm changes in all numbers
  • Major.Minor.*
    • The user will require to re-confirm changes only when Major and Minor changes occur. Revision changes will not affect the user’s page R&U approval status.
  • Major.Minor
    • The user will require to re-confirm changes when Major or Minor changes occur.
  • Major.*
    • The user will require to re-confirm changes only when Major changes occur. Minor changes will not affect the user’s page R&U approval status.
  • Major.*.*
    • The user will require to re-confirm changes only when Major changes occur. Minor and Revision changes will not affect the user’s page R&U approval status.
  • Major
    • The user will require to re-confirm changes when Major changes occur.

Updated on April 4, 2023

Was this article helpful?

Related Articles