You are here:
Unarchive from Archive Search or Archive Widget
Restore archived records with Archive Search or Archive Widget in the Archive managed package.
To preserve original audit trail data such as CreatedBy,
CreatedDate, ModifiedBy, and ModifiedDate on
restored records, assign the Set Audit Fields upon Record Creation permission to the Integration
User.
Important Considerations
- When you unarchive a root record, any associated child record is also unarchived automatically.
- Child records archived independently can’t be unarchived unless their root record is unarchived first.
- Unarchived records are assigned new IDs upon reinsertion.
- You can access logs detailing the unarchiving process on the Activities tab.
Records with related references require special handling during unarchiving. For more information, see Unarchive Related Reference Management.
- Unarchive Related References Management
The Unarchive Related References Management setting verifies data integrity during the unarchive process. Whether you want to bypass dependencies, remove reference links, or fully restore relationships, this setting provides the tools to do so safely and efficiently. - Retry Unarchive
If an unarchive operation fails, use the Retry Unarchive feature in the Archive managed package to reprocess failed records without starting over. You can rerun the unarchive process with the same or adjusted settings, depending on your needs. - Preserve the Original Case Number When Unarchiving
In the Archive managed package, when a record is created in an org, a Case Number is automatically generated on the Case Object. When a record from an archive is restored to an org, it's treated as a new record and given a new Case Number. However, there's a way to keep the original record Case Number by using a new field. - Unarchive Oversized EmailMessages
The EmailMessage HTML Body field stores the rich-text content of email messages in Salesforce, capturing formatted text, images, and embedded elements so that emails appear as they were originally sent. When an email's HTML body exceeds the maximum 131 KB size limit, Salesforce truncates the viewable content to fit within this limit. In contrast, the Archive managed package stores emails' full HTML Body content without size limitations, even for oversized messages. - Exclude Records with External References When Archiving
To avoid data recovery issues when unarchiving in the Archive managed package, select the option to skip archiving records that have links to files or systems outside Salesforce.
See Also
Unarchive from Archive Search
Archive Search provides read access to the entire Archive.
- To find the archived record you want to unarchive, use Archive Search.
-
Click the dropdown arrow on a record and select Unarchive.
A success message appears.
- Go to the Activities tab.
- Scroll to the Execution Details column, and then download the log.
Unarchive from Archive Widget
- To find the archived record you want to unarchive, go to the Related tab in the Archive Widget.
- Select the record from the dropdown menu.
-
Click the dropdown arrow on a record and select Unarchive.
A success message is displayed indicating that the unarchiving process has begun.
Unarchive Related References Management
The Unarchive Related References Management setting verifies data integrity during the unarchive process. Whether you want to bypass dependencies, remove reference links, or fully restore relationships, this setting provides the tools to do so safely and efficiently.
These actions affect the unarchive process.
- Schema changes to the object's current fields in Salesforce, and whether the unarchived record's fields match.
- Lookup relationships to other archived records.
The Unarchive Related References Management setting is critical only when an unarchived record has a lookup relationship to another record still in the archive. If the related record is live in your org, this setting doesn't apply. The lookup relationship is preserved automatically.
Unarchived Relationship Handling Options
Select one of these options to manage archived-to-unarchived relationships.
- Ignore Related References: This option unarchives only the requested root record
and the directly related child records archived with it.
This option makes sure that the unarchiving process doesn't alter any related references between records. If a record you're unarchiving has related references to other archived records, the unarchive action fails. This result maintains the integrity of dependent relationships, and makes sure that no related references are broken or inconsistent.
This option is the default setting for Unarchive Related References Management. It prevents the creation of orphaned records with broken relationship links.
Note Related references include all relationships, not only master-detail relationships. - Nullify Related Reference Links: This option prioritizes unarchiving the record
over restoring its relationships. Unarchiving a record removes any references to
other records that aren't part of the unarchive process. For example, if the
lookup field on an object is associated with an archived record, Archive sets
the lookup field value to
nullbefore reinserting the record into your org.Note The nullify action is subject to your object's schema. If the lookup field is a required field that can't be nullified, such as a master-detail relationship or universally required lookup, the unarchive job fails.This option is useful to restore a record without re-establishing its original hierarchical or dependency relationships.
- Unarchive with Related References: This option unarchives the root record and
all its related archived records, even if you archived these records in separate
operations. When complete, the unarchive job reinserts the entire chain of
related records in your org, thus preserving all relationships and dependencies.
Note This option automatically unarchives a chain of up to 100 related records per root record in the unarchive job. The operation fails if the chain exceeds 100 records.
This option is useful for unarchiving chains of related records, such as an email and its replies.
Note To unarchive EmailMessages with attachments like ContentDocuments, first turn on the Email Drafts setting in your org.
These actions generate a new Unarchive Records label in the Activities table.
Retry Unarchive
If an unarchive operation fails, use the Retry Unarchive feature in the Archive managed package to reprocess failed records without starting over. You can rerun the unarchive process with the same or adjusted settings, depending on your needs.
Key Features
- Rerun Unarchive Process: Retry the unarchive operation for records that failed during the original attempt.
- Use Original Settings or Adjust: You can use the same Unarchive Management settings as the original attempt, or adjust the settings to override the default Unarchive Management configuration.
Where to locate the Retry Unarchive feature:
- Go to the Archive Activities tab.
- To identify which records failed to unarchive, download and review the Failed Records Log.
- From the main Activities screen, go to the More Options dropdown of the activity, and select Edit.
- From the Unarchive Related References Management screen, select a different Reference Management setting, allowing for temporary overrides of the default settings, or keep the original setting.
- Select Retry Unarchive.
Preserve the Original Case Number When Unarchiving
In the Archive managed package, when a record is created in an org, a Case Number is automatically generated on the Case Object. When a record from an archive is restored to an org, it's treated as a new record and given a new Case Number. However, there's a way to keep the original record Case Number by using a new field.
To preserve the original Case Number when unarchiving a record:
- Go to Unarchive under Archive Settings.
- Select Preserve Original Case Number.
- Open the Case Object associated with the original Case Number you want to preserve.
- Click the settings icon and click Edit Object.
- Click on Case.
- Select Fields & Relationships.
- Click New.
- Select Text.
-
Click Next.
Note This format is case-sensitive. The default Case Number field length is 8 digits. In the Field Label and Field Name, enter "original_number". In the Length field, enter 8.
- Enter the details and click Next.
- Click Save.
- Navigate back to the Case Object and click the Archive tab and search in the Archive Search widget.
- Click the dropdown menu and select View.
-
Click Unarchive.
After the process is done, the
original_numberappears.
Unarchive Oversized EmailMessages
The EmailMessage HTML Body field stores the rich-text content of email messages in Salesforce, capturing formatted text, images, and embedded elements so that emails appear as they were originally sent. When an email's HTML body exceeds the maximum 131 KB size limit, Salesforce truncates the viewable content to fit within this limit. In contrast, the Archive managed package stores emails' full HTML Body content without size limitations, even for oversized messages.
While Archive stores the complete HTML body of all emails without size restrictions, unarchiving an email with an oversized HTML body fails because the Salesforce API restricts the insertion of content that exceeds this configured size limit in the EmailMessage object. Adjusting size settings in Salesforce doesn't resolve this limitation.
Important Considerations:
- Archive retains the entire email content, regardless of size. This can be beneficial for exporting.
- Oversized messages stored in Archive isn't fully restorable in Salesforce due to API limitations.
Exclude Records with External References When Archiving
To avoid data recovery issues when unarchiving in the Archive managed package, select the option to skip archiving records that have links to files or systems outside Salesforce.
If a record in Salesforce contains a reference to an external file, such as a document stored in Google Drive or on an external server, the Archive process might face limitations. Archive can store the record, but it can't access or read the content of the external file. Even more critical, trying to unarchive such a record could lead to issues because Salesforce wouldn't be able to restore the context or access the data of the external file.
The Exclude Records with External References During Archive option lets you skip archiving these specific records that depend on data managed outside Salesforce, which the system can't fully restore. When enabled, this feature ensures a smoother and more reliable data recovery process by focusing on records that can be completely and successfully restored within the Salesforce environment.
