> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/backup-and-archive/backup-and-archive-in-salesforce/time-machine/using-time-machine-component.md).

# Using Time Machine Component

## ![](https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-3f6faa4230b72167926fbc0a31dd17dc7d74581d%2FSummary2-Small-Icon.svg?alt=media) Overview

The Time Machine Component allows you to compare a record's current fields with their previously backed-up versions. With the Time Machine, you can restore previous versions of selected record fields and view records related to a specific version. You can access the Time Machine from:

* Backup Records
* A record's page
* Backup & Archive Search

{% hint style="info" %}

#### Set Up Time Machine

To use the Time Machine on a record's page, you must first add the Time Machine Lightning Web Component to the page for the desired object. Refer to the article below for detailed setup instructions.

* [Adding Time Machine Component](/backup-and-archive/backup-and-archive-in-salesforce/time-machine/adding-time-machine-component.md)
  {% endhint %}

Explore the features of the Time Machine in this guide. You can read the entire article or jump to a specific section below.

* [#access-time-machine](#access-time-machine "mention")
* [#select-versions](#select-versions "mention")
* [#hide-identical-fields](#hide-identical-fields "mention")
* [#restore-fields](#restore-fields "mention")
* [#view-record-in-flosum-backup-and-archive](#view-record-in-flosum-backup-and-archive "mention")
* [#view-related-records](#view-related-records "mention")

{% hint style="info" %}
Time Machine adheres to Field Level Security (FLS), ensuring users can only view and restore fields to which they have FLS access.
{% endhint %}

## Time Machine

{% stepper %}
{% step %}

### Access Time Machine

{% hint style="info" %}
The Time Machine can also be accessed from Backup History. See the following article for instructions.

* [Viewing Object Backup History](/backup-and-archive/backup-and-archive-in-salesforce/backup-history/viewing-object-backup-history.md#view-backup-record)
  {% endhint %}

1. Click the record you wish to use Time Machine with.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FXGkLRRcrFo1aCbHw4Vut%2FUsingTimeMachine-S01-01.png?alt=media&amp;token=b32c1f5e-0f7b-40fd-8326-1a9c1361a751" alt="" width="563"><figcaption></figcaption></figure></div>
2. Click the **Time Machine** tab.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FewR0ZJmHXRz6A1008NO2%2FUsingTimeMachine-S01-02.png?alt=media&amp;token=a7f9ed17-b0a0-41b7-a2bb-befd4f508ab7" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
If the **Time Machine** tab is not available, you must add it by editing the record's page. See the following article for instructions on adding **Time Machine**.

* [Adding Time Machine Component](/backup-and-archive/backup-and-archive-in-salesforce/time-machine/adding-time-machine-component.md)
  {% endhint %}
  {% endstep %}

{% step %}

### Select Versions

By default, **Time Machine** shows the current values for all fields for the record. You can display up to 5 previous backup versions, making it easy to track changes.

{% hint style="info" %}
The values shown in the **Time Machine** tab reflect their value at the time you open the tab. If values change, you must refresh the page to view the updated values.
{% endhint %}

1. Click **Select Versions**.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FFQvSszkamvKqWb2JhBqH%2FUsingTimeMachine-S02-01.png?alt=media&amp;token=925e682e-817c-4253-9604-9ad2d3f30a6d" alt="" width="563"><figcaption></figcaption></figure></div>
2. Click a version from the **Available Versions** list.
3. Click the **Right Arrow** to move the version to the **Selected Versions** list.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FIqZmJexhsRvYIiYFlIRM%2FUsingTimeMachine-S02-02.png?alt=media&amp;token=16aad031-5886-44b3-9bf9-57ffb11d7d87" alt="" width="375"><figcaption></figcaption></figure></div>
4. Repeat this to move up to 5 versions to the **Selected Versions** list.
5. Click **Save**.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FItZjOm5UAKFyHbDBYpUt%2FUsingTimeMachine-S02-03.png?alt=media&amp;token=4fa06f61-9298-4fa6-9cc9-c8c5a68bfd58" alt="" width="375"><figcaption></figcaption></figure></div>
6. The selected versions will now be displayed alongside the current version.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FUkh9Qt6IEn0km7WKS2yR%2FUsingTimeMachine-S02-04.png?alt=media&amp;token=66b037ce-2570-42cc-bf1b-604df435e33e" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Hide Identical Fields

To make comparing version changes easier, fields that have changed are highlighted in green. Use the **Hide Identical Fields** toggle to conceal fields that remain unchanged between versions.

1. If all fields are displayed, click the **Hide Identical Fields** toggle.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FI6xhC5PCxpR2fYjYsTDW%2FUsingTimeMachine-S03-01.png?alt=media&amp;token=96ec60ff-b78b-4809-9def-b5441af44f1e" alt="" width="563"><figcaption></figcaption></figure></div>
2. The list of fields now shows only those that have changed between versions.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FsTiTmuNitlbxQw3kptlm%2FUsingTimeMachine-S03-02.png?alt=media&amp;token=16662482-eba8-4251-bb4e-ac90ca3ba2b1" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Restore Fields

This section shows a simple example of using the restore feature. For more detailed instructions on using the restore feature, see the following article.

* [Restoring Records with Time Machine](/backup-and-archive/backup-and-archive-in-salesforce/time-machine/restoring-records-with-flosum-time-machine-in-salesforce.md)

{% hint style="info" %}
To restore a field, select a previous version first. Only non-reference fields are restorable. Fields with a greyed-out checkbox can't be restored.
{% endhint %}

{% hint style="info" %}
Time Machine only supports restoring from backups. To restore from an archive, you must use Flosum Backup & Archive. See the following article for instructions on restoring from an archive.

* [Creating an Archive Restore Job (Preparation)](/backup-and-archive/restore/prepare-restore/creating-an-archive-restore-job-preparation.md)
  {% endhint %}

1. Check the checkbox next to the field and version you want to restore.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FEcCuMsOwNI2fo3T87Bgk%2FUsingTimeMachine-S04-01.png?alt=media&amp;token=46f45160-7023-43ca-842b-304a88d5d523" alt="" width="563"><figcaption></figcaption></figure></div>
2. Check all the fields you want to restore.
3. Click **Restore**.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FQhsaGgqa6q0XhZrlrH53%2FUsingTimeMachine-S04-02.png?alt=media&amp;token=7e29211a-be37-43cf-ac20-59f65b7597f1" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
When you click **Restore**, the restoration process starts immediately without a confirmation message.
{% endhint %}
{% endstep %}

{% step %}

### View Record in Flosum Backup & Archive

When comparing previous versions of a record, you can easily view a specific version of the record in the Flosum Backup & Archive app. The link will take you to the record in the corresponding backup job's data.

1. Click the **Backup Version's Timestamp** at the top of the fields table.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fz3RBH9M9xZv14mD9cc5K%2FUsingTimeMachine-S05-01.png?alt=media&amp;token=22cc82a1-09ce-472b-96e7-3946e844c073" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
If you are not logged in to your Flosum Cloud Apps tenant, you will be directed to the Flosum Login Page. After logging in, if you are not redirected to the backup job's data, close the tab and click the **Backup Version's Timestamp** in Salesforce again.
{% endhint %}

2. View the record's fields, history, and other records in this backup.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FNNbAXIVujydSyDyqAf2p%2FUsingTimeMachine-S05-02.png?alt=media&amp;token=a48f87d6-3571-42b7-9fd2-5cbb7efdb828" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### View Related Records

The Related Records feature enables you to view accurate parent-child associations for each version. This ensures precise data restoration and enhances your understanding of historical relationships.

1. Click **Related Records** at the top right of the fields table.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2F5LNS0ohb9xR2iEEUGhg5%2FUsingTimeMachine-S06-01.png?alt=media&amp;token=3c0e52f7-7483-4e6c-bcd3-f2d467c26588" alt="" width="563"><figcaption></figcaption></figure></div>
2. Scroll through the list of **Related Objects** to find the object you wish to see related records for.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FeMy9PyqHDHGwCGayYoSY%2FUsingTimeMachine-S06-02.png?alt=media&amp;token=58edc381-1b9c-4f28-8118-3e87df7bae7f" alt="" width="563"><figcaption></figcaption></figure></div>
3. Hover over the **Info Icon** to view the field name that relates the object to the parent object.
4. Click **View All** to view a list of all records in the object that are related to the parent object.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fi2bchQTGai0X4dnp4821%2FUsingTimeMachine-S06-03.png?alt=media&amp;token=10f3b091-2cb1-4678-9f0e-3d32ed9ccc43" alt="" width="563"><figcaption></figcaption></figure></div>
5. The **Objects Related Records** page can be filtered and searched.&#x20;

   <div align="left"><figure><img src="https://646917531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FTEZEk2yIAFuD2OvSaqUH%2FUsingTimeMachine-S06-04.png?alt=media&amp;token=d7190f69-ea08-4e5b-afca-fb50e5d6109b" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/backup-and-archive/backup-and-archive-in-salesforce/time-machine/using-time-machine-component.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
