# History and versioning

The **History** feature lets you label and manage different versions of your project. You can view, download and compare project versions, restore previously deleted files, and see content added by collaborators at a glance.

## Using the full History feature

{% hint style="success" %}
Full Project History is a [premium feature](https://docs.overleaf.com/getting-started/free-and-premium-plans/premium-features). For users on our free plan, the History panel will show edits made in the last 24 hours as well as any labeled versions.
{% endhint %}

The project owner needs to be on a premium subscription in order for them and their collaborators to access the full history.

## How to access a project’s history

Select the **History** icon <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2F66j9TYEDWVpVyZp90XfO%2Fhistory-darkmode.svg?alt=media&#x26;token=7fe3e87f-4e88-420d-b796-05679367bdfb" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FzphMhjiY6zy9rG8w9WFT%2Fhistory-lightmode.svg?alt=media&#x26;token=c145358e-bffc-409b-9185-481ce59aebdb" alt="Image of the History icon" data-size="line"></picture>, located above the preview panel, to access the History feature. You can then select:

* **All history** to view all available history versions.
* **Labels** to access the list of labels you have created.

### How to return to editing mode

To exit the History mode and return to normal editing mode, select the **Back to editor** button located in the top left.

### What happens to the history if you copy a project?

A [copied project](https://docs.overleaf.com/managing-projects-and-files/copying-a-project) starts with a completely new, fresh history—the original project’s history is not copied to the new project.

## Downloading an older version of your project

When you download a project using the **Download as source (.zip)** option in the File menu, you are downloading the current version of the project. Sometimes you may wish to download an earlier version of the project.

To label or download a project version:

{% stepper %}
{% step %}
Switch to the **All history** view in History mode.
{% endstep %}

{% step %}
Select the three-dot menu <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FCs81oBunbw8hLyjNDh6C%2Fmore_vert-darkmode.svg?alt=media&#x26;token=8a6743d2-0ea6-439d-b22b-5c3c35f0e2d0" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FDT9HQwEWyBKBXn0E7rhu%2Fmore_vert-lightmode.svg?alt=media&#x26;token=559afbd1-9404-4d31-a54b-3dddf5c86be8" alt="Image of the three-dot icon, labeled &#x22;More Actions&#x22;" data-size="line"></picture> within the version you wish to download.
{% endstep %}

{% step %}
Choose **Download this version**.

<figure><picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FXrgCF7zjVZkCoZKMR7go%2Fhistorymodedownload-dark.png?alt=media&#x26;token=3573fc92-fcce-4f2d-ab57-ced76c2eeb09" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FjJnUJ0lcok7dOy8xiNJE%2Fhistorymodedownload-light.png?alt=media&#x26;token=26bb194b-116a-44ba-b32d-287e2fb8da55" alt="Image of the Download This Version option of the three-dot menu of a project version."></picture><figcaption></figcaption></figure>

A `.zip` file containing your project files is generated and downloaded to your device.
{% endstep %}
{% endstepper %}

## Labeling a project version

Version labels allow you to identify key milestones in a project and make it easier to find those versions to compare them with other versions, download them, or restore the project to that particular state.

{% hint style="info" %}
The current version of a project is labeled **Current state**.
{% endhint %}

To label a project version:

{% stepper %}
{% step %}
Switch to the **All history** view.
{% endstep %}

{% step %}
Select the three-dot menu <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FCs81oBunbw8hLyjNDh6C%2Fmore_vert-darkmode.svg?alt=media&#x26;token=8a6743d2-0ea6-439d-b22b-5c3c35f0e2d0" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FDT9HQwEWyBKBXn0E7rhu%2Fmore_vert-lightmode.svg?alt=media&#x26;token=559afbd1-9404-4d31-a54b-3dddf5c86be8" alt="Image of the three-dot icon, labeled &#x22;More Actions&#x22;" data-size="line"></picture> within the version you wish to label.
{% endstep %}

{% step %}
Choose **Label this version**.

<figure><picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2Fq54JVAKpHQyioRxDGxnn%2Fimage.png?alt=media&#x26;token=818f7411-beb2-4b1e-b5f0-6400b306940d" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FKdR3Vgx949exQfow4hlz%2Fimage.png?alt=media&#x26;token=04d2fc6a-83ed-4843-8b13-3a640ddfc4a3" alt="Image of the Label Version flow"></picture><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Type the desired label into the pop-up window and select **Add label**.

<figure><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FKhqnUrgKhnchklw2OEWN%2FScreenshot%202025-12-19%20at%2012.19.12%E2%80%AFPM.png?alt=media&#x26;token=3d366b58-3aa1-4060-ad96-937677fcbcdc" alt="Image of the Add Label modal" width="375"><figcaption></figcaption></figure>

{% hint style="success" %}
You can attach multiple labels to each project version.
{% endhint %}
{% endstep %}
{% endstepper %}

## Comparing versions

To select a range of versions to compare, use the icons <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2F8akP8a5VCFbqGl0bktzp%2Falignend_darkmode.svg?alt=media&#x26;token=76efe4c9-0869-4402-8ab7-570c3d56e122" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FuuBoBVrNfCDM2ZtZskgJ%2Falignend_lightmode.svg?alt=media&#x26;token=08a95bd4-3ea7-4593-b12d-7037f7495868" alt="Align End icon"></picture>, <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FfuCJ799B9ZGgrysAKzwR%2Falign_space_even-darkmode.svg?alt=media&#x26;token=d630fb6c-2be8-43d2-91f8-35abd457eb44" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FYUdMyxJsdHOYxWi3gXhY%2Falign_space_even-lightmode.svg?alt=media&#x26;token=00c374c8-00ff-4325-a34e-22b7fa9e9a7d" alt="Align Space Even icon"></picture>, or <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FMUPis2rdixotxNJvJAhu%2Falign_start-darkmode.svg?alt=media&#x26;token=a455c47b-743c-4b35-a292-b3d67c9ea9e0" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FuuBoBVrNfCDM2ZtZskgJ%2Falignend_lightmode.svg?alt=media&#x26;token=08a95bd4-3ea7-4593-b12d-7037f7495868" alt="Align Start icon"></picture> located on each project version. Noting that project versions are listed in chronological order, with the newest at the top and older versions lower down the list, these icons perform the following actions:

* <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FMUPis2rdixotxNJvJAhu%2Falign_start-darkmode.svg?alt=media&#x26;token=a455c47b-743c-4b35-a292-b3d67c9ea9e0" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FuuBoBVrNfCDM2ZtZskgJ%2Falignend_lightmode.svg?alt=media&#x26;token=08a95bd4-3ea7-4593-b12d-7037f7495868" alt="Align Start icon"></picture>: compare up to this version
* <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2F8akP8a5VCFbqGl0bktzp%2Falignend_darkmode.svg?alt=media&#x26;token=76efe4c9-0869-4402-8ab7-570c3d56e122" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FuuBoBVrNfCDM2ZtZskgJ%2Falignend_lightmode.svg?alt=media&#x26;token=08a95bd4-3ea7-4593-b12d-7037f7495868" alt="Align End icon"></picture>: compare from this version
* <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FfuCJ799B9ZGgrysAKzwR%2Falign_space_even-darkmode.svg?alt=media&#x26;token=d630fb6c-2be8-43d2-91f8-35abd457eb44" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FYUdMyxJsdHOYxWi3gXhY%2Falign_space_even-lightmode.svg?alt=media&#x26;token=00c374c8-00ff-4325-a34e-22b7fa9e9a7d" alt="Align Space Even icon"></picture>: compare up to this version **or** compare from this version

{% hint style="info" %} <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FfuCJ799B9ZGgrysAKzwR%2Falign_space_even-darkmode.svg?alt=media&#x26;token=d630fb6c-2be8-43d2-91f8-35abd457eb44" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FYUdMyxJsdHOYxWi3gXhY%2Falign_space_even-lightmode.svg?alt=media&#x26;token=00c374c8-00ff-4325-a34e-22b7fa9e9a7d" alt="Align Space Even icon"></picture> provides a drop-down menu offering either of the two options. This icon appears for versions in the middle of the current comparison range.
{% endhint %}

## How to restore a single file to a previous version

Follow these steps to restore a single file to a previous version. This process restores the file’s content, plus any comments and tracked changes, to the state it was in at the selected date and time.

{% stepper %}
{% step %}
Switch to the **All history** view.
{% endstep %}

{% step %}
Select the file version you wish to restore.
{% endstep %}

{% step %}
Select **Restore this version** to reinstate the file.

<figure><picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FnQGjIqcMwk0J0fiAnWUI%2Fimage.png?alt=media&#x26;token=1881445c-ac7e-44f0-9906-dc74c901aebf" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2F3EcO8n6rndcIJdD0iwRp%2Fimage.png?alt=media&#x26;token=51dd4290-61f5-476a-82ac-9626adf2cbbf" alt="Image of the history view with steps to restore a file version"></picture><figcaption><p>Steps to restore a file version</p></figcaption></figure>
{% endstep %}

{% step %}
You are asked to confirm that you want to Restore this version of the chosen file. Select **Restore** to confirm.

Overleaf restores the file and switches your project out of History mode and back to editing mode.
{% endstep %}
{% endstepper %}

## Recovering deleted files

To recover a deleted file:

{% stepper %}
{% step %}
Switch to the **All history** view.
{% endstep %}

{% step %}
Select the project version in which the file was deleted.
{% endstep %}

{% step %}
Select the deleted file from the list of project files (it will be in ~~strikethrough~~).
{% endstep %}

{% step %}
Select **Restore this version** to recover the file.

<figure><picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FJcbbevyUPysTPkGORrin%2Fimage.png?alt=media&#x26;token=afc8de56-f1cc-4ac3-8a90-7e438d0ea037" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FQo73KvBgB1w9aanIQLb6%2Fimage.png?alt=media&#x26;token=cbd4bf5a-1eeb-4787-a858-1de7abd9dc85" alt="Image showing the flow for restoring a deleted file"></picture><figcaption><p>Image showing how to restore a deleted project file using the new History user interface.</p></figcaption></figure>
{% endstep %}

{% step %}
You are asked to confirm that you want to Restore this version of the chosen file. Select **Restore** to confirm.

Overleaf restores the file and switches your project out of History mode and back to editing mode.
{% endstep %}
{% endstepper %}

## Restoring an earlier version of the project

Follow these steps to restore an entire project to a previous version. This process restores the project’s content, plus any comments and tracked changes, to the state it was in at the selected date and time.

{% stepper %}
{% step %}
Switch to the **All history** view.
{% endstep %}

{% step %}
Select the three-dot menu <picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FCs81oBunbw8hLyjNDh6C%2Fmore_vert-darkmode.svg?alt=media&#x26;token=8a6743d2-0ea6-439d-b22b-5c3c35f0e2d0" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FDT9HQwEWyBKBXn0E7rhu%2Fmore_vert-lightmode.svg?alt=media&#x26;token=559afbd1-9404-4d31-a54b-3dddf5c86be8" alt="Image of the three-dot icon, labeled &#x22;More Actions&#x22;" data-size="line"></picture> within the project version you wish to restore.
{% endstep %}

{% step %}
Choose **Restore project to this version**.

<figure><picture><source srcset="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FIv3BIapHmxmYjJQUeIet%2Frestoreproject-dark.png?alt=media&#x26;token=7132c1e3-b234-4be5-8461-1090ade5ed6d" media="(prefers-color-scheme: dark)"><img src="https://3502988919-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVetOkhFZmAC8QCQK0Pi7%2Fuploads%2FMWn1NKupr3WPgcYpB2TL%2Frestoreproject-light.png?alt=media&#x26;token=f69d5ebf-20bd-491f-a0b8-bee9484d424e" alt="Image of the Restore Project flow"></picture><figcaption><p>How to restore an Overleaf project version</p></figcaption></figure>
{% endstep %}

{% step %}
You are asked to confirm whether you want to restore the entire project to its state at the specified time and date—including any comments and tracked changes. Select **Restore** to confirm.

Overleaf restores your project, switches out of History mode and back to editing mode. You will need to select the file you want to continue editing.
{% endstep %}
{% endstepper %}
