Working with object versioning

When using object versioning, the system creates and stores separate versions of objects when they are edited and saved. This allows you to compare versions or roll back objects to previous versions.

Object versioning manages versions of system objects, such as CSS stylesheets, e-mail templates, web part containers, etc. If you are looking for versioning of content (documents), refer to the Configuring and using document versioning chapter.

Note: The object versioning functionality by itself is not a guaranteed solution for reviewing and auditing of changes made by individual users. In scenarios where multiple users concurrently edit the same object, the version history may not be completely accurate. To ensure precise version history in these scenarios, you additionally need to enable Object locking and avoid sharing of user accounts.

Supported object types

In the following table, you can find all object types that support object versioning. In the Editing interface column, you can find the exact location within the Kentico administration interface where you can edit objects of the given type. If versioning is enabled for a particular object type, the Versions tab appears in the interface, where you can view and manage the edited object’s versions.

Object type	Editing interface
Alternative forms	Forms -> edit a form -> Alternative forms -> edit an alternative form Document types -> edit a document type -> Alternative forms -> edit an alternative form Custom tables -> edit a custom table -> Alternative forms -> edit an alternative form
CSS stylesheets	Pages -> Properties -> General -> click Edit CSS stylesheets -> edit a stylesheet other interfaces containing the stylesheet selector (e.g. when editing a site, department, etc.)
Custom table definitions	Custom tables -> edit a table
Document type definitions	Document types -> edit a document type
E-mail templates	E-mail templates -> edit a template
Form definitions	Forms -> edit a form
Media files	Media libraries -> edit a library -> select a file
Newsletter issues	Newsletters -> edit a newsletter -> Issues -> edit an issue
Newsletter templates	Newsletters -> Templates -> edit a template
Page layouts *	Page layouts -> edit a layout
Page templates	Page templates -> select a template Pages -> Design -> Open the page template menu () -> hover over Edit template -> Template versions other interfaces that allow editing of page templates
Queries **	Document types -> edit a document type -> Queries -> edit a query Custom tables -> edit a table -> Queries -> edit edit a query web part properties dialogs of web parts that have query properties
Report graphs	Reporting -> select a report -> General -> select a graph and click Edit
Report tables	Reporting -> select a report -> General -> select a table and click Edit
Report values	Reporting -> select a report -> General -> select a value and click Edit
Report definitions	Reporting -> select a report
Transformations	Document types -> edit a document type -> Transformations -> edit a transformation Custom tables -> edit a table -> Transformations -> edit a transformation web part properties dialogs of web parts that have transformation properties
Web part containers	Web part containers -> edit a container
Web part layouts **	Web parts -> select a web part -> Layout -> edit a layout Pages -> Design -> Configure a web part -> Layout
* Only shared page layouts are versioned — custom layouts are versioned as part of the data of the parent page template. ** Only custom queries and web part layouts are versioned — system queries and default web part layouts are not versioned.

Settings

Even though object versioning is enabled and functional by default, we recommend configuring the related settings for your system.

Open the Settings application.
Select the Versioning & synchronization -> Object versioning category.
Configure the available settings.
Click Save.