Version History and Commenting

What are Version History and Commenting and why are they important?

Agility offers powerful and robust tools that give Editors a running list of changes that have been made to a piece of content over time, information on what modifications were made, who made them and when, the ability to restore those earlier versions at any time, and the option to add comments to document and share important information about the content or changes that have been made with your team. 

You can view this information for:

• Content 
• Pages

View Version History

You can access Version History at any time by going into Edit mode for the Content or Page that you’re managing and clicking the Clock icon on your right-hand panel. 

From the here you can see the Version History as well as what state that version is currently in. 

To see what changed in an earlier version, click the Compare Versions icon on that version. The Compare Page Versions or Compare Content Versions window opens with the current version on the left and the version you picked on the right. The Version row at the top shows each version's number and state, and marks the current one Current.

Compare Page Versions

A page compare is split into the same sections as the page's side panel. Click a section's heading to collapse or expand it.

• SEO: the page's SEO fields, in the same order as the SEO tab, including the Page Path.
• Properties: the page type, page model, Build Pages From and its related field, the link URL and target, and the page's settings.
• Components: each zone and its components. A component is marked Added, Removed or Moved, and a moved component shows the zone it moved from or to.

To compare the page with its published version, click the eye icon (View Currently Published Version) in the page header. It appears when the page has changes that aren't published yet.

Moving a page to a different place in the sitemap saves a new version, but the compare doesn't show the move.

Compare Content Versions

A content compare shows each changed field of the item side by side. Image and file fields show the file with its details, such as its type, size and URL. For a rich text field, turn on Use Split View to see the two versions next to each other.

Only Changes Are Shown

Both compares show only what changed between the two versions. Fields, components and sections that are the same in both are left out.

If the two versions have the same content, you'll see No content changes. The versions can still differ in status or publishing details, which the compare doesn't count as a content change.

Restore an Earlier Version

1. Open the compare window for the version you want to restore (see above).

2. Click Restore in the Version row, under the version you picked. You need edit permission to see Restore.

3. Confirm by clicking Restore in the pop-up.

4. Your earlier version will then be restored in a Staging State for you to review and edit if you wish 

5. To fully restore this version to your live site, click Publish 

View Comments

The comments on each item can be found in the same panel on the right-hand side of your screen, directly below your Version History. It's indicated by a chat icon.

From this section you can leave comments for other editors to give context on changes you might have made or ask questions. You can also interact with individual comments by clicking the drop-down menu on each one.

Live Commenting

Our Web Studio update also introduces Live Commenting and Collaboration. Not only can you now comment via the commenting panel, but you can also react to those comments, start threads and leave interactive comment bubbles on specific items.

To access Commenting Mode, first navigate to Web Studio and the click the Comment bubble in the centre of your top toolbar.

Once your team has installed the Web Studio SDK, you'll even be able to drag and re-position comments in Commenting Mode.

Agility offers powerful Content Versioning that allows Content Editors to review versions of content and revert to any point in time.

Select an Image

Benefits of Version History

Version History in Agility provides you with a running list of all the changes that have occurred within a piece of content over its lifetime. Specifically, Version History gives you access to old copies or versions of content, which includes information regarding who modified each version of content and when.

What is Versioned in Agility?

With Agility Version History, you are able to view past versions of Content, Pages and Page Modules.

View a Previous Version

To view a list of changes made, navigate to the History tab on a Content Item Page, or Page Module.

Select an Image

Restore a Previous Version

To restore a previous version, select the version from the History tab, then click Restore this Version. This will restore the Content Item or Page to the previous version in a Staging state.

Select an Image