> ## Documentation Index
> Fetch the complete documentation index at: https://docs.realtimelca.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Revisions

> Named save points of the whole project, and how to move between them.

A **revision** is a named save point of the whole project, kept until an admin deletes it — *Initial Design*, *Detailed Design*, *Planning submission*.

The project is always on exactly one revision, the **current** one, and everything you do is saved to it. The project never drifts away from the revision it is on.

Find them under **History → Revisions**.

<Frame caption="The Revisions tab">
  <img className="block dark:hidden" src="https://mintcdn.com/real-timelca/SULuzJ4XbI2MHEEp/images/user-guide/Revisions%20annotated.png?fit=max&auto=format&n=SULuzJ4XbI2MHEEp&q=85&s=ebbdd527c3ce67e427749e58f72844f9" alt="Revisions tab with callouts for the view switcher, the explainer, the save button, the emission change per revision, and the preview and continue actions." width="4443" height="2300" data-path="images/user-guide/Revisions annotated.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/real-timelca/SULuzJ4XbI2MHEEp/images/user-guide/Revisions%20annotated-dark.png?fit=max&auto=format&n=SULuzJ4XbI2MHEEp&q=85&s=1f17995b51017d0c1550fc9c32c8cc6a" alt="Revisions tab with callouts for the view switcher, the explainer, the save button, the emission change per revision, and the preview and continue actions." width="4443" height="2300" data-path="images/user-guide/Revisions annotated-dark.png" />
</Frame>

## Create a revision

**Save current state as revision** captures the project as it stands right now.

You can also promote an older point: open the **⋮** menu on any entry in the [history log](/user-guide/project/project-history) and choose **Save as revision**.

Name it after the milestone it represents rather than the date — the date is recorded anyway.

## Reading the list

Each revision shows who saved it, when, and the project's emission figure at that point. Where a figure has moved, the change from the previous revision is shown beside it — *0.13 kgCO₂-eq/m²/year, −0.1* — so the effect of a design stage is visible without opening anything.

## Preview or continue

The two actions on a revision are different, and the difference matters:

| Action                 | Who      | What happens                                                                                                        |
| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| **Preview**            | Any user | Opens that revision read-only. The project keeps working from its current revision; nothing changes.                |
| **Continue from this** | Admin    | Moves the project's working state to that revision. It becomes the current one, and every open client follows live. |

Switching back and forth is safe. Each revision keeps the work done while it *was* current, so continuing from another one neither creates a save point nor loses one.

<Note>
  **Continue from this** is not the same as [restoring a version](/user-guide/project/project-history#restore-a-version). Continuing moves *this* project onto a revision it already holds. Restoring rebuilds materials and project data from the event store at a pinned point into a **new** project, leaving this one untouched.
</Note>

## Switch from anywhere

You do not have to come back to this tab. The revision name in the breadcrumb is a switcher, available on every page of the project.

<Frame caption="The breadcrumb switcher">
  <img src="https://mintcdn.com/real-timelca/OHc_irHb_01DyAk6/images/user-guide/screens/Revisions%20switcher.png?fit=max&auto=format&n=OHc_irHb_01DyAk6&q=85&s=8db084842d0418497b1d56544e002876" alt="Revision dropdown in the breadcrumb listing the current and other revisions with a manage revisions link, and a banner explaining that an earlier revision is being previewed." width="3104" height="2024" data-path="images/user-guide/screens/Revisions switcher.png" />
</Frame>

Picking another revision previews it, and a banner makes clear you are looking rather than working — **Back to current** returns you. **Manage revisions** opens this tab.

## Rename and delete

Renaming and deleting are admin actions. Renaming changes only the name — nothing about the saved state. The revision the project is currently on cannot be deleted.

## Why they matter for reporting

Exported [reports](/user-guide/project/reports) are pinned to a revision. A report names the revision and version it was taken from, and is listed while the project is on — or previewing — that revision.

That is what makes a delivered number reproducible: months later you can preview the revision a report was issued from and see exactly the figures behind it, even though the live project has moved on.

<Tip>
  Save a revision at every milestone you report on — a planning submission, a design freeze, a client issue. It costs nothing, and the emission delta between revisions then tells the story of the project on its own.
</Tip>

## Comparing design stages

Because each revision is a complete state of the project, previewing two in turn is the simplest way to see what changed between design stages — the dashboard totals, the mapping progress, and the charts all follow.

For comparing variants side by side rather than in sequence, [clone the project](/user-guide/project/clone-project) instead and change one thing in the copy.
