Working with Page Versions working-with-page-versions

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

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 creating-a-new-version

You can create a version of your resource from:

Creating a New Version - Timeline 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:

    screen_shot_2018-03-21at155035

  5. Select Save as Version.

  6. Enter a Label and Comment if required.

    chlimage_1-398

  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 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:

    screen_shot_2012-02-15at105050am

  5. Confirm the new version with Create.

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

Reverting to a Page Version reverting-to-a-page-version

Once a version has been created you can revert to that version if needed.

NOTE
When restoring a page, the version created will be part of a new branch.
To illustrate:
  • Create versions of any page.
  • The initial labels and version node names will be 1.0, 1.1, 1.2 and so forth.
  • Restore the first version; i.e. 1.0.
  • Create new versions again.
  • The generated labels and node names will now be 1.0.0, 1.0.1, 1.0.2, etc.

To revert 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:

    screen_shot_2018-03-21at155246

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

Previewing a 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:

    screen_shot_2018-03-21at155330

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

    note caution
    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 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:

    screen_shot_2018-03-21at155330

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

Timewarp timewarp

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

The purpose is to allow you to track the published website at the selected point in time. This uses the page versionss 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 this 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 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.

    screen_shot_2018-03-21at155416

  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.

    screen_shot_2018-03-21at155513

  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.

    screen_shot_2018-03-21at155544

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.
CAUTION
Timewarp is designed as a tool to assit authors with understanding and creating their content. It is not intended as an audit log or for legal purposes.
recommendation-more-help
5f6f1f67-8db1-40cb-84e9-024e65b9fc4c