# Record Lineage Parameters

Record Lineage specific parameters. Record Lineage maps a logical record to one or more physical forms over time, tracking how the record evolves within the same system or across different systems.

![](https://2924009365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5FyPmqVkPxhj2oT8fbgB%2Fuploads%2Fgit-blob-002ac4193b72496c914ad09be2b5a09ce00543af%2F6db582b1-GlobalParams_LineageScreen1.png?alt=media)

| Parameter                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Create Record Lineage                    | If checked, CopyStorm/Restore will create a lineage entry when a record is inserted. If unchecked, no lineage entry will be created on insert.                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Enable Record Lineage Candidate Scanning | If checked, CopyStorm/Restore will consider record lineage when performing a candidate scan. If unchecked, CopyStorm/Restore will not consider record lineage during Candidate Scans. Refer to [this article](https://learn.capstorm.com/copystorm-restore/frequently-asked-questions/how-does-record-lineage-work) for details on how lineage affects Candidate Scanning.                                                                                                                                                                                                                                      |
| Related Lists Scan Option                | <p>Configures how CopyStorm/Restore manages related list relationships when determining record lineage during the restoration process.<br>Available values are:</p><ul><li>Do Not Scan Old Lineage – When performing a candidate scan, only the related lists of the HEAD lineage are scanned.</li><li>Require Consistent Relationships – When performing a candidate scan, child records are scanned only if they maintain a consistent relationship with the parent’s HEAD.</li><li>Scan Old Lineage – When performing a candidate scan, lineage is ignored, and all child records are considered..</li></ul> |
| Reference Field Scan Option              | <p>Configures how CopyStorm/Restore manages reference field relationships when determining record lineage during the restoration process.</p><ul><li>Do Not Scan Old Lineage – When performing a candidate scan, only the referenced records of the HEAD lineage are scanned.</li><li>Require Consistent Relationships – When performing a candidate scan, referenced records are scanned only if they maintain a consistent relationship with the parent’s HEAD.</li><li>Scan Old Lineage – When performing a candidate scan, lineage is ignored, and all referenced records are considered..</li></ul>        |


---

# 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/copystorm-restore/reference/global-parameters-tab/record-lineage-parameters.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.
