# Managing content revisions

{% embed url="<https://vimeo.com/488356227>" %}

## Revisions overview

GovCMS creates a new **revision** every time a *content page* is updated. This allows you to track how the content has changed over time on your site.

## View revisions

To view and manage revisions, use the **Revisions tab**. To access this, navigate to the *Content* page, then click on a piece of *content*. Then click on the **Revisions** button (highlighted in the screenshot below):

<figure><img src="https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2F7C1NLZEwglfRovULdHI3%2Fimage.png?alt=media&#x26;token=173abbf2-463a-4a8c-9d31-35ca9a93062e" alt=""><figcaption><p>Image of Revisions menu tab</p></figcaption></figure>

From the Revisions tab, you can view the individual revisions, revert to an earlier revision, and delete revisions.

Information about each revision of the content is displayed, including :

1. Date and time of the revision.
2. Who updated the content (creating the revision).
3. The revision log message, if entered and the status of the revision at the time it was created (in brackets).
4. Radio buttons used to select revisions to **Compare** (see below).
5. Operations dropdown, which allows a user to *Revert* the content to the selected revision, or *Delete* the selected revision.
6. The **Compare selected revisions** button (see below for information on this feature).

These items are highlighted and numbered in the following screenshot:

![Image of Revision information](https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2Fgit-blob-e80cf20aee9727264c87c79d3c88738375b0d727%2FUnit-4-Revisions-2.png?alt=media)

**Note**: Depending on your website configuration, not every user role can access the Revisions tab.

## View differences between revisions

There are two main ways to view the differences between revisions.

Firstly, clicking on the date and time link of a given revision will take you to that revision or version of the file (see 1. in the screenshot above).

Secondly, to see the differences between two different revisions select the radio buttons in the rows of the revisions you wish to compare, then click on the **Compare selected revisions** button.

![Image of compare revisions with radio buttons](https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2Fgit-blob-2c07a9efedabf672f294d40e402d16ae2d1ad44f%2FUnit-4-Revisions-3.png?alt=media)

The screenshot below shows what was changed between the versions, namely:

1. Renaming the page.
2. Addition of a *Featured image* and a *Thumbnail* image.

It also shows which revisions of the page are being compared (3.)

![Image of Revisions what has changed](https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2Fgit-blob-01b38b75cbedd5e04dc33dbbc1750ad9a7c8027d%2FUnit-4-Revisions-4.png?alt=media)

## Revert revisions

GovCMS also creates a new revision when a user **reverts** to a previous revision.

If you have four revision versions (eg, 1, 2, 3 and current, when you revert to #2, then a copy of #2 is made and the copy is set as the current revision.

After the reversion, there are five versions/revisions (1, 2, 3, 4 and current), where current is a clone of #2.

## Revision log message

Another useful feature of the revision system is the *Revision log message* field, which appears near the *Create a new revision* checkbox at the top right of the content editing form.

![Image highlight Revision log message](https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2Fgit-blob-665958db3d63c10d65960e679ee49f58cc2aa435%2FUnit-4-Revisions-5.png?alt=media)

If a message is added to this field when creating a revision, the message will appear on the *Revisions tab* along with the revision.

While the *Revision log message* is an **optional** field, it is recommended to add a meaningful message whenever a revision is created. This is so that others (or you, months later) can see why the content was changed and what the changes were, without having to actually view previous revisions.

## Scheduled Transitions

Scheduled transitions is useful if you want to update the revision at a specified date/time.&#x20;

To schedule a transition, simply navigate to the "Schedule transitions" tab as shown below:

<figure><img src="https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2F7Jqr719jFukVXcstIrQY%2Fimage.png?alt=media&#x26;token=814a18aa-8844-4022-897b-d5ac513b011d" alt=""><figcaption><p>Highlighting the Scheduled Transitions tab</p></figcaption></figure>

Then click on "Add Scheduled transition":

<figure><img src="https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2FIScnM9qqs26FKhobdrp9%2Fimage.png?alt=media&#x26;token=b0e0ee6b-e051-4f44-bea0-a2d90d8d0c23" alt=""><figcaption><p>Highlighting the "Add Scheduled transition" button</p></figcaption></figure>

Select the revision to transition, and then set the new transition state along with the execution time and date as shown below:

<figure><img src="https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2FhR3yYtebDU9KaJEkl3Le%2Fimage.png?alt=media&#x26;token=e45894c0-5612-4a51-9222-247d159dd595" alt=""><figcaption><p>Adding a scheduled transition</p></figcaption></figure>

After clicking on the "Schedule transtion" button, the confirmation screen looks like this:

<figure><img src="https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2FWWKFxzmxWp9kYTdl3C1l%2Fimage.png?alt=media&#x26;token=5e521a9e-a509-40cf-908e-d7bd186a5599" alt=""><figcaption><p>Confirmation screen of a scheduled transition</p></figcaption></figure>

You can find all pending scheduled transitions by going to Content >> Scheduled transitions as show below:

<figure><img src="https://1079433754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyh9JMywljz0CN8oT8o%2Fuploads%2F13WgWC7XVS5vavPYGOY0%2Fimage.png?alt=media&#x26;token=fdee84ea-513b-4c0d-bf10-8e7a379abd80" alt=""><figcaption></figcaption></figure>

The transition will be executed at the specified time (thanks to the automatic cronjobs).&#x20;

<mark style="color:red;">**A crucial point to keep in mind is that cron runs once every hour at a randomly chosen minute. Therefore, it is possible that the transition may not occur precisely at the specified time. Nevertheless, it will be executed within one hour of the designated time.**</mark>