Skip to the content
Documentation

Versions and drafts

No ratings yet

Every save of an item is a version. A published version is never changed in place: each edit makes a new version, and the one it replaces is kept. This page explains the states of a version, the versions page, comparing versions and going back to an earlier one. It replaces the earlier page "Undoing changes".

Drafts and versions

State What it means
Draft Being written. Only its creator sees and edits it.
Pending Sent for publishing, but a workflow holds it, usually an approval.
Published The version the site shows. An item has one published version at a time, the current version.
Archived An earlier published version, kept so you can go back to it.

A draft holds the language you edit. When you translate an item into a new language, the draft holds only that translation; the other languages stay as they are published. When the draft is published, it becomes the current version and the version before it is archived.

Open the versions page

On the item's page, press the round button with a clock (Manage versions). In the edit form the same button is in the left column. The menu of an item in the tree has Manage versions too.

The top of an article's page with the round Manage versions button outlined

The round button with a clock on an item's page opens its versions.

The versions page

The versions page of an article: the overview, the filters, two versions with View, Compare and Make a new draft, and Compare two versions

The versions page: an overview, filters by status and order, one row per version with View, Compare and Make a new draft, and Compare two versions at the bottom. The creators' names are hidden in this picture.

  • The overview counts the versions: published, archived, translations, and your own drafts.
  • Status and Order filter the list (all, published, archived, drafts) and sort it (newest first, oldest first, last modified).
  • Each version shows its number and state, its translations with the one that was changed, its creator and its dates, with the buttons View and Compare.
  • New draft from this version, in chooses a translation of that version, and Make a new draft copies it into a new draft of yours.
  • Compare two versions, at the bottom, compares any two versions in one translation.
  • Remove selected versions deletes the versions you ticked.

Compare two versions

  1. Under Compare two versions, choose the Older version, the Newer version and the Translation.
  2. Press Show differences. The changes are marked field by field: removed text struck through, added text underlined. Inline changes and Block changes show the changes in two ways; Old version and New version show one version alone. Close the comparison goes back to the list.

The Compare button of a row compares that version with the newest other version you may read.

The differences between two versions of an article, field by field

Show differences marks what changed between two versions, field by field: removed text struck through, added text underlined.

Go back to an earlier version

  1. On the versions page, find the version you want, with View or Compare.
  2. In its row, choose the translation under New draft from this version, in and press Make a new draft.
  3. Open the new draft (or, with Stay on this page after making a new draft unticked, it opens in the edit form at once), check it, and press Send for publishing.

The old content is published again as the newest version. Nothing is lost: the version you replaced is archived in turn. The same works for a draft of someone else: the new draft is yours.

How many versions are kept

A site keeps a limited number of versions per item. A new installation keeps 45, and 75 for folders. When an edit goes over the limit, the oldest archived version of that item is removed. An administrator can change the limits in content.ini, block [VersionManagement].

Who may do it

Editors who may edit the item. Reading other people's versions needs the right to read versions; removing versions needs the right to remove them.

What can go wrong

  • An old version cannot be edited. Only drafts can be edited. Make a new draft from it.
  • Other languages look different after going back. The new draft is made in one language; the other translations keep their published text.
  • Removed versions are gone for good, with all their translations. The published version, and versions held by a workflow, can never be removed.
  • "Version history limit has been exceeded and no archived version can be removed by the system." The item holds as many drafts and pending versions as the limit allows. Publish or remove some drafts of it, or ask an administrator to raise the limit.

Read more

Contributors

Comments

Add a comment

Comments are read by a moderator before they appear.