--- schema_version: "1" id: a9e7f89fc8fd446adc8028953e078eec721b33006fea3242c9eb167d558a0e5c title: Uninstall NPSP collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/sfdo/264-0-0/npsp_uninstall.md canonical_url: https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 9b8dab3e0546f3774fa873f5a932591433ff29330602d740b9eae7720a757c12 description: This article provides instructions for uninstalling a default version of NPSP from your Salesforce organization. products: - Nonprofit release: "264" --- # Uninstall NPSP This article provides instructions for uninstalling a default version of NPSP from your Salesforce organization. ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/images/icon_important.png) Important If you're installing the latest version of NPSP, you do not need to uninstall any previous versions. Additionally, you should only uninstall NPSP if you no longer need to use it. Uninstalling will not help troubleshoot issues, and may result in data loss. - **[Overview](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** To uninstall the Nonprofit Success Pack (NPSP) you must uninstall all of its related packages. NPSP version 3.0 or later includes these packages. - **[Back Up Your Data](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** When you uninstall a package, all of its components, custom fields and data are deleted from your Salesforce organization. Be sure you understand the impact uninstalling NPSP will have on your org! - **[Remove Profile Access to the NPSP App](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** For the System Administrator profile and each custom profile, make sure that NPSP isn't the default app. - **[Delete NPSP Page Layouts for Standard Objects](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** Delete the NPSP page layouts before you can uninstall. In some cases you need to assign or create a non-NPSP page layout so that your standard objects still have an active page layout. - **[Remove NPSP Elements from Non-NPSP Custom Page Layouts](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** If you included any NPSP page elements (such as buttons or related lists) on non-NPSP page layouts, you must remove them. Note that these are just some of the most common customizations that are possible. - **[Remove NPSP Lightning Record Pages as Defaults](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** Remove the Lightning record pages as the org default. - **[Revert Button Overrides to Default](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** NPSP changes the behavior of these standard Salesforce buttons. - **[Delete NPSP Custom Metadata](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** Delete NPSP custom metadata types before you uninstall NPSP. - **[Remove NPSP Home Visualforce Page](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** The NPSP Home Visualforce page was included in some versions of the NPSP trial. If you find you have this page, you should remove it. - **[Remove Level Components](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** Remove NPSP picklist values from the Target field and replace with non-NPSP value. - **[Uninstall NPSP Packages in the Correct Order](https://help.salesforce.com/s/articleView?id=sfdo.npsp_uninstall.htm&release=264.0.0&type=5)** Now you should be able to uninstall the six NPSP Packages. You must uninstall the NPSP Packages in this exact order. ## Overview To uninstall the Nonprofit Success Pack (NPSP) you must uninstall all of its related packages. NPSP version 3.0 or later includes these packages. - Affiliations - Contacts & Organizations - Households - Nonprofit Success Pack - Recurring Donations - Relationships Only a system administrator or implementation partner should uninstall NPSP. The uninstall process can take several hours or even longer to complete. Your users should not access Salesforce while you're uninstalling NPSP. ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/images/icon_important.png) Important If you want to remove NPSP, you **must** uninstall all six packages following the step-by-step instructions below. When you uninstall a package, wait until you receive an email confirmation that the package has uninstalled before proceeding with the next one. **Failure to follow the steps in the correct order prevents packages from being removed successfully.** If you uninstall only the Nonprofit Success Pack package without removing the others, your org may be left in an unstable state, as there is code and functionality in the Nonprofit Success Pack packages that the other packages rely on. ### Alternatives to Uninstalling Because NPSP contains so many components, it can be difficult to uninstall especially if your organization has been using NPSP for a while or you've extended NPSP with your own customizations. Instead of uninstalling, you might consider moving to a new Salesforce org. In this scenario, you're starting over with a new Salesforce implementation, so you'll be re-building from the ground up. [Contact your Account Executive](https://www.salesforce.com/campaign/your-account/) or implementation partner to discuss options. ## Back Up Your Data When you uninstall a package, all of its components, custom fields and data are deleted from your Salesforce organization. Be sure you understand the impact uninstalling NPSP will have on your org! Learn how to back up your data in [Export Backup Data from Salesforce](https://help.salesforce.com/s/articleview?id=xcloud.admin_exportdata.htm&type=5). ## Remove Profile Access to the NPSP App For the System Administrator profile and each custom profile, make sure that NPSP isn't the default app. 1. Click ![Setup](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/resources-product/images/setup.png), then click **Setup**. 2. From Setup, enter Profiles in the Quick Find box, then select **Profiles**. 3. Click **System Administrator**, then click **Assigned Apps**. 4. For the Nonprofit Success Pack rows, make sure that **Default** is not selected. If it is, click **Edit** and select a different default app. You can leave the Nonprofit Success Pack rows Visible. 5. Click **Save**. 6. Repeat these steps for all custom profiles, even profiles that you aren't actively using. ## Delete NPSP Page Layouts for Standard Objects Delete the NPSP page layouts before you can uninstall. In some cases you need to assign or create a non-NPSP page layout so that your standard objects still have an active page layout. Delete and replace these NPSP page layouts: | **Object Name** | **Page Layout to Delete** | | --- | --- | | Account | Household Layout | | Account | Organization Layout | | Account | Household Lightning Layout | | Account | Organization Lightning Layout | | Campaign | NPSP Campaign Layout | | Contact | Contact Layout | | Contact | Contact Lightning Layout | | Opportunity | Donation Layout | | Opportunity | In-Kind Layout | | Opportunity | Grant Layout | | Opportunity | Major Gift Layout | | Opportunity | Matching Gift Layout | | Opportunity | Membership Layout | 1. From Setup, click the **Object Manager** tab. ![Object Manager tab in the Setup window.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_objmgrtab.png) 2. In the list of objects, click the name of one of the objects listed above. 3. Click **Page Layouts**. 4. In the row for the page layout you want to delete, click ![Show more actions icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/resources-product/images/show_more_actions_icon.png), then click **Delete**. 5. To replace the layout you're deleting, select a non-NPSP Page Layout. If there isn't another page layout listed in the **Replace with Page Layout** menu, you may need to [create one](https://help.salesforce.com/apex/htviewhelpdoc?id=customize_layoutcreate.htm&language=en_US). If you need to create a new layout, don't copy the layout from an existing NPSP layout. In some cases you may need to create a page layout from scratch. 6. Click **Replace**. 7. Repeat these steps for each page layout listed above. ![Page Layout Delete page showing the Replace button highlighted.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_replacepl.png) ## Remove NPSP Elements from Non-NPSP Custom Page Layouts If you included any NPSP page elements (such as buttons or related lists) on non-NPSP page layouts, you must remove them. Note that these are just some of the most common customizations that are possible. ### Account Remove the **New Account Donation** button. 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Account**. 3. Click **Page Layouts**. 4. Click the page layout name. 5. On the Opportunities related list, click the wrench icon. 6. In the Buttons section, click **Revert to Defaults** to remove the custom **New Account Donation** button and enable the standard **New** button. ![Page Layout Buttons section, showing the Revert to Defaults button highlighted.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_reverttodefaults.png) 7. Click **OK**. 8. Click **Save**. ### Campaign Remove the **Household Mailing List** button and the **GAU Allocations** related list. 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Campaign**. 3. Click **Page Layouts**. 4. Click the page layout name. 5. Drag the **Household Mailing List** button from the Custom Button section to the field section at the top of the page. 6. Remove the **GAU Allocations** related list by clicking ![Button to remove a related list from a page layout](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_removerl.png) on its title bar. 7. Click **Save**. ### Contact Remove the **Relationships Viewer, Recalculate Rollups** and **New Contact Donation** buttons. 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Contact**. 3. Click **Page Layouts**. 4. Click the page layout name. 5. Drag the **Relationships Viewer** button from the Custom Button section to the field section at the top of the page. 6. Drag the **Recalculate Rollups** button from the Custom Button section to the field section at the top of the page. 7. Drag the **Recalculate Rollups** button from the Salesforce Mobile and Lightning Experience Actions section to the field section at the top of the page. 8. On the Opportunities related list, click the wrench icon. 9. In the Buttons section, click **Revert to Defaults** to remove the **New Contact Donation** button and enable the standard **New** button. 10. Click **OK**. 11. Click **Save**. Delete the **New Donation**, **New Membership**, **New Major Gift**, and **New In-Kind Gift** actions: 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Contact**. 3. In the row for New Donation, click arrow, then click **Delete**. 4. Repeat these steps for New Membership, New Major Gift, and New In-Kind Gift. ### Opportunities Remove the **Matching Donation**, **Email Acknowledgment**, **Manage Soft Credits**, and **Refresh Name** buttons and **GAU Allocations**, **Partial Soft Credits**, and **Payments** related lists. 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Opportunity**. 3. Click **Page Layouts**. 4. Click the page layout name. 5. Drag the **Matching Donation**, **Email Acknowledgment**, **Manage Soft Credits**, and **Refresh Name** buttons from the Custom Button section to the field section at the top of the page. 6. Drag the **Manage Soft Credits** button from the Salesforce Mobile and Lightning Experience Actions section to the field section at the top of the page. 7. Remove the **GAU Allocations**, **Partial Soft Credits**, and **Payments** related lists by clicking ![Button for removing a related list from a page layout](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_removerl.png) on their title bars. 8. Click **Save**. Remove the **Email Acknowledgment** button from the Opportunities Search layouts. 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Opportunity**. 3. Click **Search Layouts**. 4. In the row for the Default Layout, click ![Show more actions icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/resources-product/images/show_more_actions_icon.png), then click **Edit**. 5. Click the left arrow to remove **Email Acknowledgments** from the Selected Buttons. 6. Click **Save**. Remove the **Email Acknowledgment** button from Search Layouts for Salesforce Classic: 1. In **Setup**, click the **Object Manager** tab. 2. In the list of objects, click **Opportunity**. 3. Click Search Layouts for Salesforce Classic. 4. In the row for List view, click the arrow, then click **Edit**. 5. Click the left arrow to remove **Email Acknowledgments** from the Selected Buttons. 6. Click **Save**. Remove the **Partial Soft Credits** related list from Opportunity page layouts: 1. In **Setup**, click the **Object Manager** tab. 2. In the list of objects, click **Opportunity**. 3. Click **Page Layouts**, then click **Donation Layout**. 4. Scroll down to the Related Lists section. 5. Click Remove Related List in the Partial Soft Credits related list. 6. Click **Save**. 7. Repeat these steps for all other Opportunity page layouts. Delete the **New Deliverable** action: 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Opportunity**. 3. In the row for New Deliverable, click the arrow, then click **Delete**. ### Recurring Donations Remove the **Recalculate Rollups**, and **Refresh Opportunities** buttons and the **GAU Allocations** related list: 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Recurring Donation**. 3. Click **Page Layouts**. 4. Click the page layout name. 5. Drag the ****Recalculate Rollups**, and **Refresh Opportunities**** buttons from the Custom Button section to the field section at the top of the page. 6. Remove the **GAU Allocations** related list by clicking ![Button for removing a related list from a page layout](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_removerl.png)on its title bar. 7. Click **Save**. Remove the **Active Schedules** and **Upcoming Installments** Lightning components from Lightning record pages. 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click **Recurring Donation**. 3. Click **Lightning Record Pages**. 4. Click the page layout name. 5. Click **Edit**. 6. Find the Active Schedules component on the layout and click remove. ![Remove Lightning component icon highlighted.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall-remove-lightning-component.png) 7. Find the Upcoming Installment component on the layout and click remove. 8. Click **Save**. ## Remove NPSP Lightning Record Pages as Defaults Remove the Lightning record pages as the org default. - NPSP Account Record Page - NPSP Contact Record Page - NPSP Campaign Record Page - NPSP Lead Record Page - NPSP Opportunity Record Page - NPSP GAU Allocation - NPSP General Accounting Unit To remove a Lightning record page as the org default: 1. From **Setup**, enter Lightning App Builder in the Quick Find box, then click **Lightning App Builder**. 2. Click **Edit** next to the record page name. 3. Click **Activation**. 4. Click **Remove as Org Default**. 5. Click **Next**. Select **System Default** (or any non-NPSP Lightning record page). 6. Click **Save**. 7. Repeat these steps for all NPSP Lightning record pages listed above. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/images/icon_note.png) Note You may also need to remove the record pages as the app default. After clicking **Activation**, click **App Default** and follow the rest of the steps outlined above. ## Revert Button Overrides to Default NPSP changes the behavior of these standard Salesforce buttons. | **Object Name** | **Button Name** | | --- | --- | | Contact | Delete | | Lead | Convert | Before uninstalling NPSP, you must restore the behavior to use default Salesforce pages. 1. In Setup, click the **Object Manager** tab. 2. In the list of objects, click the name of one of the objects listed above. 3. Click **Buttons, Links, and Actions**. 4. In the row with the button to be deleted, click ![Show more actions icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/resources-product/images/show_more_actions_icon.png), then click **Edit**. 5. Select **No Override (use default)**. ![Override properties on a Button, showing that there is No Override (use default).](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_nooverride.png) 6. Click **Save**. 7. Repeat these steps for each button listed above. ## Delete NPSP Custom Metadata Delete NPSP custom metadata types before you uninstall NPSP. Delete records for these NPSP Custom Metadata Types: - Data Import Field Mapping - Data Import Field Mapping Sets - Data Import Object Mapping - Data Import Object Mapping Set - Filter Group - Filter Rule - Opportunity Stage to State Mapping - Recurring Donation Status Mapping - Rollup To delete Custom Metadata Type records: 1. In **NPSP Settings**, click **Donations** | **Customizable Rollups**. Click the toggle to disable Customizable Rollups. 2. Click **System Tools** | **Advanced Mapping for Data Import & Gift Entry**. Click the toggle to disable Advanced Mapping. 3. In **Setup**, enter Custom Metadata Types in the Quick Find and click **Custom Metadata Types**. 4. Click **Manage Records** next to Data Import Field Mapping. 5. Click **Del** next to each record until you've deleted all records. 6. Repeat steps 3 - 5 for the remaining Custom Metadata Types listed above. ## Remove NPSP Home Visualforce Page The NPSP Home Visualforce page was included in some versions of the NPSP trial. If you find you have this page, you should remove it. 1. In Setup, search for Visualforce. 2. Click on **Visualforce Pages**. 3. Click N on the alphabet bar to navigate to pages that begin with N. 4. Click **Del** to the left of the NPSP\_Home page. ![Del link highlighted next to the NPSP\_Home page.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_dellink.png) ## Remove Level Components Remove NPSP picklist values from the Target field and replace with non-NPSP value. 1. In Setup, click **Object Manager**. 2. Click **Level**. 3. Click **Fields & Relationships**. 4. Click **Target**. 5. In the Values section, click **New**. 6. Enter Placeholder, then click **Save**. This step is necessary because a picklist must have at least one active value. 7. In the Values section, click **Del** next to Account. Click Ok in the pop-up window. 8. Select Replace value on records with blank value. 9. Click Save. 10. Repeat steps 7 - 9 for the Contact picklist value. Delete and erase the **Level** and **Previous Level** fields on the Account object. 1. In Setup, click **Object Manager**. 2. Click **Account**. 3. Click **Fields & Relationships**. 4. In the row for Level, click the arrow and click **Delete**. 5. Click **Delete** in the pop-up window. 6. In the row for Previous Level, click the arrow and click **Delete**. 7. Click **Delete** in the pop-up window. 8. Click your profile picture and click **Switch to Salesforce Classic**. 9. Click **Setup**. 10. Enter Accounts in the Quick Find box. 11. Click **Fields**. 12. Scroll to the bottom of the Account Custom Fields & Relationships section. 13. Click **Deleted Fields**. 14. In the row for Level, click **Erase**. 15. Select Yes, I want to permanently delete the custom field, and click **Delete**. 16. In the row for Previous Level, click **Erase**. 17. Select Yes, I want to permanently delete the custom field, and click **Delete**. 18. Click **Switch to Lightning Experience**. ## Uninstall NPSP Packages in the Correct Order Now you should be able to uninstall the six NPSP Packages. You must uninstall the NPSP Packages in this exact order. 1. Nonprofit Starter Pack/Nonprofit Success Pack 2. Affiliations 3. Relationships 4. Recurring Donations 5. Households 6. Contacts & Organizations To uninstall a package: 1. From Setup, enter **Installed Packages** in the Quick Find box, then click **Installed Packages**. 2. Click **Uninstall** next to the package name. ![The Uninstall link in the Installed Packages list.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/nonprofit_success_pack/images/uninstall_npsp_uninstallaction.png) 3. Check the box next to **Yes, I want to uninstall this package and permanently delete all associated components**. You can also select the option to save object data for 48 hours. 4. Click **Uninstall**. 5. **Wait for an email** that confirms that the uninstall was successful before moving on to the next package. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sfdo-nonprofit_success_pack-264-0-0-production-enus/bd2879e2-2bdc-4012-aa32-dc0c697c4538/images/icon_note.png) Note The uninstall might not succeed the first time you try it. There may be additional NPSP components that you need to remove. You'll be presented with a list of remaining components for each package as you try the uninstall. Remove the additional components and try the uninstall again until you can uninstall all the packages. **Congratulations! You survived the uninstall experience.**