---
title: Settings - Object versioning
---

> 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).

You can access these settings in the **Settings** application under the **Versioning & Synchronization** -> **Object versioning** category.

| General                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable object versioning                       | Globally enables or disables [object versioning](https://docs.kentico.com/13/configuring-xperience/working-with-object-versioning.md). This option is enabled by default. If disabled, no versions are created when objects are modified.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Delete objects to recycle bin                  | Determines which objects the system stores in the recycle bin when they are deleted.<br>**No** – no objects are moved to recycle bin when deleted, i.e. they are deleted permanently.<br>**Versioned objects only** – only objects that support versioning and have versioning enabled are moved to the recycle bin when deleted. You can select the objects in the _Use object versioning for_ section of the settings below.<br>**All objects** – all objects that support [staging synchronization](https://docs.kentico.com/13/deploying-websites/content-staging.md) are moved to the recycle bin when deleted.<br>**Note**: Storing very large media files in the recycle bin consumes a significant amount of memory and space in the database. If your system contains such files, we recommend selecting the _Versioned objects only_ option and keeping versioning disabled for _Media files_. |
| Team development                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Use check-in/check-out for objects             | Indicates if [object locking](https://docs.kentico.com/13/custom-development/extending-the-administration-interface/preparing-your-environment-for-team-development/working-with-object-locking.md) (check-in/check-out) should be used for virtual objects. See [Preparing your environment for team development](https://docs.kentico.com/13/custom-development/extending-the-administration-interface/preparing-your-environment-for-team-development.md).                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Keep new objects checked out                   | Indicates if new objects are automatically checked out upon creation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Version history                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Version history length (minor versions)        | Indicates how many [minor versions](https://docs.kentico.com/13/configuring-xperience/working-with-object-versioning/using-object-versioning.md) of a single object the system stores in the version history.<br>If the number of versions exceeds this value, the oldest version is deleted. If set to 0, the minor version history length is unlimited.<br>**Note**: If you set the value to a lower number, the system automatically clears the current version history for all objects according to the new limit.                                                                                                                                                                                                                                                                                                                                                                                   |
| Version history length (major versions)        | Indicates how many [major versions](https://docs.kentico.com/13/configuring-xperience/working-with-object-versioning/using-object-versioning.md) of a single object the system stores in the version history.<br>If the number of major versions exceeds this value, the oldest version is deleted. If set to 0, major versions history length is unlimited.<br>**Note**: If you set the value to a lower number, the system automatically clears the current version history for all objects according to the new limit.                                                                                                                                                                                                                                                                                                                                                                                |
| Save to last version if younger than (minutes) | If an object is edited and saved within this number of minutes since it was last saved, changes made to it are saved to the last version. If it is saved after more minutes since it was last saved, a new version is created. If set to 0, a new version is created whenever you save an edited object.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Promote to major version if older than (hours) | If an object is edited and saved after this number of hours since it was last saved, a new major version is created. If it is saved earlier, a new minor version is created or the changes are saved to the latest version (depending on the setting above). If set to 0, major versions are never created automatically.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Use object versioning for                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Alternative forms                              | Indicates if versioning of page type, on-line form and custom table [alternative forms](https://docs.kentico.com/13/custom-development/extending-the-administration-interface/creating-alternative-forms.md) is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Automation processes                           | Indicates if versioning of [marketing automation process](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/marketing-automation.md) objects is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Custom table definitions                       | Indicates if versioning of custom table definitions is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Page type definitions                          | Indicates if versioning of page type definitions is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Email templates                                | Indicates if versioning of [email templates](https://docs.kentico.com/13/configuring-xperience/managing-email-templates.md) is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Form definitions                               | Indicates if versioning of on-line form definitions is allowed (in the Forms application).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Media files                                    | Indicates if versioning of media library files is allowed.<br>**Note**: Versioning of very large media files may consume an extensive amount of database space and memory. This option is disabled by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Media files versioned extensions               | Extensions of versioned media files. Only media files with extensions enumerated here will be versioned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Marketing emails                               | Indicates if versioning of marketing emails is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Marketing email templates                      | Indicates if versioning of marketing email templates is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Email widgets                                  | Indicates if versioning of email widgets is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Page layouts                                   | Indicates if versioning of page layouts is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Page templates                                 | Indicates if versioning of [page templates for the administration interface](https://docs.kentico.com/13/custom-development/extending-the-administration-interface/developing-the-administration-using-portal-engine/creating-portal-engine-templates.md) is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Queries                                        | Indicates if versioning of page type and custom table queries is allowed. Only custom queries are versioned – system queries are not versioned because they are re-generated by the system automatically when their parent object is modified.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Report graphs                                  | Indicates if versioning of report graphs is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Report tables                                  | Indicates if versioning of report tables is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Report values                                  | Indicates if versioning of report values is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Report definitions                             | Indicates if versioning of report definitions is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Transformations                                | Indicates if versioning of [transformations](https://docs.kentico.com/13/macro-expressions/writing-transformations-for-macros.md) is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| UI element                                     | Indicates if versioning of [UI elements](https://docs.kentico.com/13/custom-development/creating-custom-modules/reference-managing-ui-elements.md) is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Web part layouts                               | Indicates if versioning of web part layouts is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Workflows                                      | Indicates if versioning of [workflow](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-workflows.md) objects is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
