---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/reports/versioning
  - ru/reports/versioning
  - href: en/reports/versioning.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: en/reports/versioning.html
title: Report versioning
description: In this article, you will learn about report versioning and version types.
vcsPath: en/reports/versioning.md
---

# Versioning

Report versioning means storing the history of report configuration changes through versions. A list of versions is available to users with the lowest edit permission for the report.

To go to the list of versions, click <!-- diplodoc:svg ![image](../_assets/console-icons/ellipsis.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg> at the top of the screen and select <!-- diplodoc:svg ![image](../_assets/console-icons/clock.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M13.5 8a5.5 5.5 0 1 1-11 0 5.5 5.5 0 0 1 11 0M15 8A7 7 0 1 1 1 8a7 7 0 0 1 14 0M8.75 4.5a.75.75 0 0 0-1.5 0V8a.75.75 0 0 0 .3.6l2 1.5a.75.75 0 1 0 .9-1.2l-1.7-1.275z" clip-rule="evenodd"/></svg> **Change history**.

![image](../_assets/datalens/concepts/report-version-list.png)

To select a version from the list, click it. The version number will be displayed in the `revId` parameter in the report address string. Click a link with the version number in the `revId` parameter to open the relevant version of the report.

Unsaved changes in the current version are reset:

* When refreshing the page.
* When saving a report.
* When switching to another version.

## Version types {#version-types}

All versions fall into the following types:

1. **Current**: This is the most recently saved version of a report.

   The version is displayed:
   
   * To all users on dashboards.
   * When navigating to a report.
   * When opening a report in a workbook.
   * When using the dashboard context menu to open a report for editing.
   
   A report can only have one current version.

   A user with **Write** permissions can make any report version current.
  
   {% note warning %}
  
   When you update any version, except a draft, a new report version is created.

   {% endnote %}
  
1. **Outdated**: This version is no longer current.  
   When you open an outdated version, a panel appears at the top indicating the version type, creation date and time, and login of the version author. There are buttons in the right-hand panel:

   * **Make current**: Turns an outdated version into the current one. The version current at the time will become outdated.
   * **Open current**: Opens the current version.

   {% cut "Outdated version" %}

   ![image](../_assets/datalens/concepts/report-irrelevant-version.png)

   {% endcut %}

![image](../_assets/datalens/concepts/report-version-types.png)

{% note tip %}

You can share any report version by adding the `revId` parameter to the report link, e.g., `?revId=zac5m4edoaqqr`.

{% endnote %}

## Creating a new version {#version-create}

A new version is automatically created:

* In the current/outdated report version edit mode, after you click **Save** (which creates a new current version).
* In outdated report version view mode, after you click **Make current**.

Below are report configuration changes that create a new version once they are saved:

* Editing [report settings](./report-operations.md#report-settings).
* Editing report [page settings](./report-operations.md#page-settings).
* [Adding](./report-operations.md#add-widget), editing, or [removing](./report-operations.md#delete-widget) widgets.
* [Moving](./report-operations.md#move-widget-front-or-back) a widget to the foreground or background.
* Adding, deleting, or editing selector settings.

## Editing versions {#version-edit}

You can edit any version of a report.

### Editing a current version {#actual-version-edit}

Editing a report opens its current version by default. To save your changes, click **Save** at the top right. This will create a new current version, making the previous one outdated.

### Editing an outdated version {#current-version-edit}

To edit an outdated version, select it from the list of versions. To save your changes to an outdated version, click **Save** at the top right. This will create a new current version, making the previous one outdated.

## Limitations {#restrictions}

* Change history is only available for the last three months.
* The change history only contains a list of report versions and indicates the version type, save date and time, and user who made the change.
* Report versions do not include changes to access permissions; this operation is performed separately from report edits.
* Versions do not display a list of changes. You can only view the saved status of the report configuration.