Working with Page Versions

Versioning creates a “snapshot” of a page at a specific point in time. With versioning, you can perform the following actions:

• Create a version of a page.
• Restore a page to a previous version in order to undo a change that you made to a page, for example.
• Compare the current version of a page with a previous version with differences in the text and images highlighted.

Creating a New Version

You can create a version of your resource from:

• the Timeline rail
• the Create option (when a resource is selected)

Creating a New Version - Timeline

1. Navigate to show the page for which you want to create a version.

2. Select the page in selection mode.

3. Open the Timeline column.

4. Click/tap on the arrowhead by the comment field to reveal the options:

   

5. Select Save as Version.

6. Enter a Label and Comment if required.

   

7. Confirm the new version with Create.

   The information in the timeline will be updated to indicate the new version.

Creating a New Version - Create with a Selected Resource

1. Navigate to show the page for which you want to create a version.

2. Select the page in selection mode.

3. Select the Create option from the toolbar.

4. The dialog will open. You can enter a Label and a Comment if required:

   

5. Confirm the new version with Create.

   The timeline will be opened with the information updated to indicate the new version.

Reinstating Versions

Once you have created a version of your page, there are various methods of reinstating a prior version:

• the Revert to this Version option from the Timeline rail

  Reinstate a prior version of a selected page.

• the Restore options from the top actions toolbar

  • Restore Version

    Reinstate versions of specified pages within the currently selected folder; this can also include restoring pages that have been previously deleted.

  • Restore Tree

    Reinstate a version of an entire tree as at a specified date and time; this can include pages that have been previously deleted.

Revert to a Version

To Revert the selected page to a previous version:

1. Navigate to show the page you want to revert to a previous version.

2. Select the page in selection mode.

3. Open the Timeline column and select either Show All or Versions. The page versions for the selected page will be listed.

4. Select the version you want to revert to. The possible options will be shown:

   

5. Select Revert to this Version. The selected version will be restored and the information in timeline will be updated.

Restore Version

This method can be used to restore versions of specified pages within the current folder; this can also include restoring pages that have been previously deleted:

1. Navigate to, and select, the required folder.

2. Select Restore, then Restore Version from the top actions toolbar.

   NOTE

   If, either:

   • you have selected a single page, that has never had any child pages,
   • or none of the pages in the folder have versions,

   Then the display will be empty as there are no versions applicable.

3. The available versions will be listed:

   

4. For a specific page, use the drop down selector under RESTORE TO VERSION to select the required version for that page.

   

5. In the main display, select the required page to be restored:

   

6. Select Restore for the selected version, of the selected page, to be restored as the current version.

Restore Tree

This method can be used to restore a version of a tree as at a specified date and time; this can include pages that have been previously deleted:

1. Navigate to, and select, the required folder.

2. Select Restore, then Restore Tree from the top actions toolbar. The latest version of the tree will be shown:

   

3. Use the date and time selector at Latest Versions at Date to select another version of the tree - the one to be restored.

4. Set the flag Preserved Non Versioned Pages as required:

   • If active (selected), then any non-versioned pages will be maintained and not impacted by the restore.

   • If inactive (unselected), then any non-versioned pages will be removed as they did not exist in the versioned tree.

5. Select Restore for the selected version of the tree to be restored as the current version.

Previewing a Version

You can preview a specific version:

1. Navigate to show the page you want to compare.

2. Select the page in selection mode.

3. Open the Timeline column and select either Show All or Versions.

4. The page versions will be listed. Select the version you want to preview:

   

5. Select Preview. The page will be shown in a new tab.

   CAUTION

   If a page has been moved, you can no longer perform a preview on any versions made before the move.

   • If you experience problems with a preview, check the Timeline for the page to see whether the page has been moved.

Comparing a Version with Current Page

To compare a previous version with the current page:

1. Navigate to show the page you want to compare.

2. Select the page in selection mode.

3. Open the Timeline column and select either Show All or Versions.

4. The page versions will be listed. Select the version you want to compare:

   

5. Select Compare to Current. The page diff will open and display the differences.

Timewarp

Timewarp is a feature designed to simulate the published state of a page at specific times in the past.

Because content creation is an ongoing and collaborative process, the purpose of Timewarp is to allow authors to track the published website over time in order to understand how the content has changed. This feature uses the page versions to determine the state of the publish environment.

To do this:

• The system looks for the page version that was active at the selected time.
• This means the version shown was created/activated before the point in time selected in Timewarp.
• When navigating to a page that has been deleted, it will also be rendered - as long as the old versions of the page are still available in the repository.
• If no published version is found, then Timewarp will revert to the current state of the page on the author environment (this is to prevent an error/404 page, which would prevent browsing).

Using Timewarp

Timewarp is a mode of the page editor. To start it, simply switch it as you would any other mode.

1. Start the editor for the page where you wish to start Timewarp and then select Timewarp in the mode selection.

   

2. In the dialogue set a target date and time and click or tap Set Date. If you do not select a time, the current time will default.

   

3. The page is displayed based on the date set. Timewarp mode is indicated via the blue status bar at the top of the window. Use the links in the status bar to select a new target date or exit Timewarp mode.

   

Timewarp Limitations

Timewarp makes a best effort to reproduce a page at a selected point in time. However because of the complexities of the continuous authoring of content in AEM, this is not always possible. These limitations should be kept in mind as you use Timewarp.

• Timewarp works based on published pages - Timewarp will only work fully if you have previously published the page. If not, timewarp will show the current page on the author environment.

• Timewarp uses page versions - If you navigate to a page that has been removed/deleted from the repository it will be rendered properly if old versions of the page are still available in the repository.

• Removed versions affect Timewarp - If versions are removed from the repository then Timewarp cannot show the correct view.

• Timewarp is read-only - You cannot edit the old version of the page. It is only available for viewing. If you want to restore the older version you will have to do that manually using restore.

• Timewarp is only based on page content - If elements (such as code, css, assets/images, etc) for rendering the website have changed, the view will differ from what it originally was, as those items are not versioned in the repository.