Loading

Best Practices When Uninstalling an App or Package in Salesforce

Date de publication: Jul 5, 2026
Description


Carefully review the details in Uninstalling a Package.

Check with your entire user base to evaluate and ensure that no one is actively using the app's features or functionality, to prevent being caught off guard.

If you have a sandbox, attempt the package or app uninstall there first. It is also a good idea to test with a small subset of users after uninstalling to ensure the changes will not impact primary business processes or functions.
Before uninstalling in Production, always ensure that you have performed and downloaded a recent full data export. For more information, see Export Backup Data from Salesforce.

Warning — Back Up Your Data Before Uninstalling

Backing up your data prior to a package uninstall is critical. Package uninstall data deletion may also affect data contained outside of the app's direct components or functionality.

Typically, dependencies built to package components will prevent an uninstall. However, records contained in an object outside the package may contain referential data that is removed or deleted as part of the package's uninstall.

For more details on deletion behaviors with regards to object relationships, see Considerations for Relationships and Object Relationships Overview.

Résolution


What Happens During an Uninstall

During the uninstall process, carefully read and acknowledge the warning message presented on the screen. Uninstalling a package will:

  • Permanently delete all components in this package
  • Permanently delete all customizations you have made to these components

When you uninstall a package, by default, all its data as well as related notes and attachments are automatically saved as an export file. This file is available for 48 hours in case you need to recover the data. To reload the data, import the export file manually and recreate any relationships between objects. Some components cannot be recreated and others require special treatment. You can also prevent the package data from being exported by selecting the appropriate radio button.

Note: Each org's customizations are unique. It is not within the scope of Support's offerings to perform metadata or impact analysis on a customer's behalf for uninstalling a package. For more, see Admin Assist: FAQ.

Save and Download Package Data Export

Always select the "Save a copy of this package's data for 48 hours after uninstall" option and promptly download any resulting package data export files once the uninstall is complete. This is important in case you need to re-install and re-import the data. See Importing Package Data for more details.

Numéro d’article de la base de connaissances

000383933

 
Chargement
Salesforce Help | Article