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; for example:
  • to undo a change that you made to the page.
• Compare the current version of a page with a previous version:
  • to highlight differences in the text and images.

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 on the arrowhead by the comment field to reveal the options:

   

5. Select Save as Version.

6. Enter a Label and Comment if necessary.

   

7. Confirm the new version with Create.

   The information in the timeline is 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 to open the dialog.

4. In the dialog box, you can enter a Label and a Comment, if necessary:

   

5. Confirm the new version with Create.

   The timeline is 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 that 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 are listed.

4. Select the version that you want to revert to. The possible options are shown:

   

5. Select Revert to this Version. The selected version is restored and the information in timeline 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 is empty as there are no versions applicable.

3. The available versions are 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 is 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 are maintained and not impacted by the restore.

   • If inactive (unselected), then any non-versioned pages are 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 that 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 are listed. Select the version that you want to preview:

   

5. Select Preview. The page is 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 that 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 are listed. Select the version that you want to compare:

   

5. Select Compare to Current. The page diff opens to display the differences.

Timewarp

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

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

• The system looks for the page version that was active at the selected time.
  • This page version was created/activated before the point in time selected in Timewarp.
• When navigating to a page that has been deleted, it is also rendered - as long as the old versions of the page are still available in the repository.
• If no published version is found, then Timewarp reverts to the current state of the page on the author environment (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 dialog, set a target date and time and click Set Date. If you do not select a time, the current time is taken as the 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 only works fully if you have previously published the page. If not, timewarp shows 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 is 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 have to do that manually using restore.

• Timewarp is only based on page content - If elements for rendering the website have changed, the view differs from what it originally was, as those items are not versioned in the repository. Such elements include code, css, assets/images, among others.