> 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/migration-setup-tab/original-record-id-rule-tools.md).

# Original Record Id Rule Tools

The Original Record Id Rule tool is used to create a custom field in the target Salesforce and populate the new custom field with record Ids from the CopyStorm backup database. This is useful in a number of migration scenarios when the original Id of records being migrated must be maintained.

For example:

* The Original Id may be used after the migration to correlate data between the source and target orgs.
* Salesforce Id may be used as a key by an external system which must be able to access the original Salesforce Id.

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

## Original Id Field Configuration

Original Id field creation is enabled by checking the “Enable this Feature” checkbox. Available options include:

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

| Configuration Option | Description                                                                                                                                                                                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable This Feature  | Check this checkbox to enable Original Id column creation and population.                                                                                                                                                                                              |
| Field API Name       | The Salesforce API Name of the Original Id field. This field will be created automatically if it does not already exist.                                                                                                                                               |
| Field Label          | The Label to use when creating the Original Id field.                                                                                                                                                                                                                  |
| Permission Set Name  | When creating an Original Id field on a Salesforce Object, CopyStorm/Restore will update this Permission Set to allow access to the new field. This permission set will be created and assigned to the CopyStorm/Restore Salesforce User if it does not already exist. |
| Field Description    | The Description to use when creating the Original Id field.                                                                                                                                                                                                            |