---
title: Working with object versioning
related:
  - https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-and-using-page-versioning.md
  - https://docs.kentico.com/13/custom-development/extending-the-administration-interface/preparing-your-environment-for-team-development/working-with-object-locking.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

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.

> **Info:** Object versioning manages versions of system objects, such as media files, email templates, etc. If you are looking for versioning of content (pages), refer to the [Configuring and using page versioning](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-and-using-page-versioning.md) chapter.

> **Note:** **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](https://docs.kentico.com/13/custom-development/extending-the-administration-interface/preparing-your-environment-for-team-development/working-with-object-locking.md) 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 Xperience 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.

> **Info:** **Versioning live site code and objects**
>
> Many of the object types that support versioning are only used when [extending and developing the administration interface](https://docs.kentico.com/13/custom-development/extending-the-administration-interface.md) (web parts, transformations, etc.).
>
> Live site development scenarios instead utilize a larger number of code files in the MVC project, such as page views, CSS files or [page builder components](https://docs.kentico.com/13/developing-websites/page-builder-development.md). You can version such code files using a standard source control system (Team Foundation Server, Git, etc.), and combine it with the Xperience object versioning feature for objects managed in the administration interface.

| Object type                                                                                                                                                                                                                                               | Editing interface                                                                                                                                                                                 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Alternative forms                                                                                                                                                                                                                                         | Page types -> edit a page type -> Alternative forms -> edit an alternative form<br>Custom tables -> edit a custom table -> Alternative forms -> edit an alternative form                          |
| Automation processes                                                                                                                                                                                                                                      | Marketing automation -> Processes -> edit a process                                                                                                                                               |
| Custom table definitions                                                                                                                                                                                                                                  | Custom tables -> edit a table                                                                                                                                                                     |
| Page type definitions                                                                                                                                                                                                                                     | Page types -> edit a page type                                                                                                                                                                    |
| Email templates                                                                                                                                                                                                                                           | Email templates -> edit a template                                                                                                                                                                |
| Form definitions                                                                                                                                                                                                                                          | Forms -> edit a form                                                                                                                                                                              |
| Media files                                                                                                                                                                                                                                               | Media libraries -> edit a library -> select a file                                                                                                                                                |
| Marketing emails                                                                                                                                                                                                                                          | Email marketing -> edit an email feed -> Emails -> edit an email                                                                                                                                  |
| Marketing email templates                                                                                                                                                                                                                                 | Email marketing -> Email templates -> edit an email template                                                                                                                                      |
| Email widgets                                                                                                                                                                                                                                             | Email marketing -> Email widgets -> edit an email widget                                                                                                                                          |
| Page layouts \*                                                                                                                                                                                                                                           | Page layouts -> edit a layout                                                                                                                                                                     |
| Page templates                                                                                                                                                                                                                                            | Administration interface -> Page templates -> select a template<br>other interfaces that allow editing of page templates                                                                          |
| Queries \*\*                                                                                                                                                                                                                                              | Page types -> edit a page type -> Queries -> edit a query<br>Custom tables -> edit a table -> Queries -> edit edit a query<br>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                                                                                                                                                                                                                                           | Page types -> edit a page type -> Transformations -> edit a transformation                                                                                                                        |
| UI elements                                                                                                                                                                                                                                               | Modules -> edit a custom module -> User interface -> select a UI element in the tree                                                                                                              |
| Web part layouts \*\*                                                                                                                                                                                                                                     | Administration interface -> Web parts -> select a web part -> Layout -> edit a layout<br>Administration interface -> Page Templates -> Design -> Configure a web part -> Layout                   |
| Workflows                                                                                                                                                                                                                                                 | Workflows -> edit a workflow                                                                                                                                                                      |
| \* Only shared page layouts are versioned – custom layouts are versioned as part of the data of the parent page template.<br>\*\* 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. For example, you can allow versioning of different object types, or configure the version history length.

1. Open the **Settings** application.
2. Select the **Versioning & synchronization -> Object versioning** category.
3. Configure the [available settings](https://docs.kentico.com/13/configuring-xperience/managing-sites/configuring-settings-for-sites/settings-versioning-synchronization/settings-object-versioning.md).
4. Click **Save**.