# Using Time Machine Component

## ![](/files/CBvqj0H8446fKLeXtHLv) 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. 

   <div align="left"><figure><img src="/files/UM0QKJXeN2nAN4cPivS1" alt="" width="563"><figcaption></figcaption></figure></div>
2. Click the **Time Machine** tab.&#x20;

   <div align="left"><figure><img src="/files/bGmWa02CzcqDa6jwIOOl" 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="/files/IVJIol1GjsYfPqBmZLII" 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="/files/HcoRMle6ltnvOp4tes3p" 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="/files/ZURmq4eVKDKLTIPPtjxN" 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="/files/xl1mj0Lf0lrVaDKWLZHB" 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="/files/sCRsHPT2hwfC9w5qTXg3" 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="/files/zMAPds9WgW973q0VVq02" 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="/files/e4SYJp9OD8hXpSHdSEaI" 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="/files/OqyZS9goLp1kpmbeKyPT" 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 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="/files/GHhh2bP0AOtbUnP2TuVU" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
If you are not logged into your tenant on Flosum Cloud Apps, you must first:

1. Log in to your tenant.&#x20;

2. Once logged in, if you are not taken to the backup job's data.&#x20;

3. Close the tab.&#x20;

4. Click the **Backup Version's Timestamp** from Salesforce again.
   {% endhint %}

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

   <div align="left"><figure><img src="/files/ymuNLuMmKI9jEivq6U6J" 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="/files/qAFBl3jWb6UNNjZGhtSI" 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="/files/PcJfmVf4PsIctxfZ8NY2" 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="/files/Q7mO8eXTcho2Ez5IWi73" 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="/files/dafnhnEb3i2UTDjG2V9i" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.