> For the complete documentation index, see [llms.txt](https://learn.capstorm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.capstorm.com/copystorm-restore/reference/global-parameters-tab/record-lineage-parameters.md).

# 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](/copystorm-restore/frequently-asked-questions/how-does-record-lineage-work.md) 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>        |
