# Step 3: Scan Records

This stage is the “sanity check + planning” step. The wizard scans what you selected (records + related depth + field settings) and builds a list of restore candidates. Once the scan finishes, you’ll click Restore to move forward.

![](/files/wFr8i8BBe1W4uS5IG7s0)

## What This Step is Doing

When you click **Scan Records**, the restore wizard:

* Evaluates your selected **top-level object records** (from Step 1)
* Applies your Step 2 settings (Restore Type, Object Settings, Related List Depth, Automation choice)
* Determines which objects/records are in-scope and counts them as **candidates**
* Prepares the restore job so the next steps can upload/apply the data

## Screen Layout

You’ll see:

* **Scan Records** button (starts the scan)
* **Cancel Scan** button (enabled while a scan is running)
* A grid with:
  * **Status** – progress/state of scanning for that object
  * **Object** – the Salesforce object being scanned (top-level and/or related objects)
  * **# Candidates** – how many records were found that are eligible for restore
* Restore button (top-right) – this is what you click after the scan completes to continue

## How to use this Step

### **1) Start the scan**

Click **Scan Records.**

As the scan runs, the table will populate with one or more rows (depending on your related list depth and what relationships exist).

### **2) Watch status + candidate counts**

Use the table to confirm the restore scope makes sense.

* If you expected “just a handful” and you see a huge number of candidates, your settings are probably too broad (most commonly **Related List Depth = All**).
* If you expected results and candidates are zero, your filters/selection may be too narrow, or you may be restoring the wrong snapshot/object.

### **3) Cancel if needed**

If you realize the scan is going in the wrong direction (wrong object, wrong depth, candidate count exploding), hit **Cancel Scan**, then go Previous Step to adjust.

### **4) Continue**

Once the scan is complete, click **Restore** to proceed to the next stage.

## How to Interpret “# Candidates”

A **candidate** is a record the restore job has identified as in-scope for restoration based on your selections and settings.

Candidate count is heavily influenced by:

* **Related List Depth** (None vs 1/2/3 vs All vs Custom)
* Your Step 1 **Filters**
* How many related/child records exist in your data model

## Common Issues / Quick Fixes

### **“This is way too many records”**

* Go back to **Configuration** and reduce **Related List Depth** (try **None** or **1 Level** first).
* Tighten Step 1 filters to target a smaller set.

### **“No candidates show up”**

* Verify you selected the right **Database** + **Data Set (snapshot)** and **Object** in Step 1.
* Loosen filters and re-run the scan.
* Confirm you aren’t using **Update Only** when the target org doesn’t already contain those records (that can result in fewer/no eligible candidates depending on matching behavior).

### **Scan takes a long time**

* Big restores are usually caused by deep relationship depth + lots of related data.
* Cancel, reduce depth, and re-scan to validate scope before committing.


---

# 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://learn.capstorm.com/capstorm-container/reference/restore-wizard/step-3-scan-records.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.
