You are here:
Configure Automated and Manual Soft Credits
Find out more about configuring automated and manual soft credits.
- About Soft Credits
Soft credits represent recognition credit for donations. For example, when a company matches an employee's gift, the employee gets a soft credit for the matching gift. - Add Opportunity Contact Roles
Nonprofit Success Pack comes with many Opportunity Contact Roles. Create additional Opportunity Contact Roles to meet your organization's need. - Enable Soft Credit Fields
Assign Read and Edit permissions for following fields to your System Administrator and other relevant profiles and permission sets. - Enable Manage Soft Credits Button
The Manage Soft Credits button allows users to create and edit full or partial soft credits on Opportunities. - Enable Automated Household Member Soft Credits
NPSP provides a unique type of soft credit for Households—the Household Member soft credit. With Household Member soft credits, everyone in the Household receives a soft credit for a donation made by anyone else in the Household. - Enable Contact Role for Organizational Opportunities
For Organizational gifts, you may wish to assign a soft credit to someone who helped you win the gift, for example, a board member. NPSP can automatically credit the Contact named in the Primary Contact field on an Organizational Opportunity. - Enable Relationship and Affiliation Soft Credits
NPSP can automatically create soft credits based on Relationship and Affiliation records. - Enable Partial Soft Credits
Make sure the Partial Soft Credit object is accessible to all profiles that also have access to Opportunities. - Enable Account Soft Credits
Before you can use Account Soft Credits, you need to give users access to the Account Soft Credit object and fields, and add the Account Soft Credit related list to your page layout. You can also optionally add more Account Soft Credit roles. - Additional Soft Credits Configuration
These NPSP features use soft credits and may require configuration before use in your org.
About Soft Credits
Soft credits represent recognition credit for donations. For example, when a company matches an employee's gift, the employee gets a soft credit for the matching gift.
Learn more in Soft Credits Overview.
NPSP creates soft credits automatically in a variety of scenarios. Read Automated Soft Credits for more information. You can also manually Manually Create Soft Credits.
Feature Release Information
This feature was released in NPSP version 3.63 (2/3/2016).
Add Opportunity Contact Roles
Nonprofit Success Pack comes with many Opportunity Contact Roles. Create additional Opportunity Contact Roles to meet your organization's need.
Nonprofit Success Pack comes with these Opportunity Contact Roles out of the box.
- Donor
- Household Member
- Soft Credit
- Matched Donor
- Honoree
- Notification Recipient
- Grant Manager
- Decision Maker
- Influencer
- Solicitor
- Workplace Giving
- Other
Make sure these roles are present in your org. Create additional roles to meet your organization's needs.
- From Setup, enter Contact Roles in the Quick Find box, then select Contact Roles on Opportunities.
- Click New to add Opportunity Contract Roles.
- Click Save to finish.
Enable Soft Credit Fields
Assign Read and Edit permissions for following fields to your System Administrator and other relevant profiles and permission sets.
Assign Field-Level Security
Contact fields:
-
First Soft Credit Amount
-
First Soft Credit Date
-
Largest Soft Credit Amount
-
Largest Soft Credit Date
-
Last Soft Credit Amount
-
Last Soft Credit Date
-
Number of Soft Credits
-
Number of Soft Credits Last N Days
-
Number of Soft Credits Last Year
-
Number of Soft Credits This Year
-
Number of Soft Credits Two Years Ago
Relationship fields:
- Related Opportunity Contact Role
Affiliation fields:
- Related Opportunity Contact Role
For more information on setting field-level security, see Verify Access for a Particular Field.
.
Add Fields to Page Layouts
Add the fields listed above to these page layouts:
-
Add Contact fields to the Contact Layout.
-
Add Relationship fields to the Relationship Layout.
-
Add Affiliation fields to the Affiliation Layout.
For more information on adding fields to page layouts, read Customize Page Layouts with the Enhanced Page Layout Editor.
Enable Manage Soft Credits Button
The Manage Soft Credits button allows users to create and edit full or partial soft credits on Opportunities.
Assign Permissions for the Manage Soft Credits Button
To allow users (including admins) to manage soft credits, grant these permissions for the Partial Soft Credit object and fields:
- Create and Delete access on the Partial Soft Credit object
- Read and Edit access on the Amount, Contact Role Id, and Role Name fields
- Read access on the Contact Name field
Assign Manage Soft Credits Visualforce Page
- From Setup, go to Profiles.
- Select the profile you wish to edit.
- Click Visualforce Page Access.
- Click Edit.
- Find and select PSC_ManageSoftCredits in Available Visualforce Pages.
- Click Add.
- Click Save.
Add Manage Soft Credits Button to Opportunity Page Layout
- From Object Manager, find and select Opportunity.
- Click Page Layouts.
- Select Donation Layout.
- In the palette, click Buttons.
- Click and drag Manage Soft Credits to Custom Buttons in the page layout details section.
- Click Save.
Add Manage Soft Credits Button to Partial Soft Credits Related List
- From Object Manager, find and select Opportunity.
- Click Page Layouts.
- Select Donation Layout.
- In the palette, click Related Lists.
- Using the wrench icon, edit the related list properties for Partial Soft Credits.
- Click the plus-sign to expand the Buttons section.
- In Available Button, click Manage Soft Credits.
- Click Add.
- Click OK.
- Click Save.
Enable Automated Household Member Soft Credits
NPSP provides a unique type of soft credit for Households—the Household Member soft credit. With Household Member soft credits, everyone in the Household receives a soft credit for a donation made by anyone else in the Household.
For more information and examples, see Soft Credits Overview.
To enable Automated Household Member soft credits:
-
Click
, then click NPSP Settings.
- Click .
- Click Edit.
- If it is not already selected, select Household Contact Roles On.
- In the Household Member Contact Role field, select the Contact Role you want to use for automatic soft crediting. We recommend selecting the default, Household Member.
-
(Optional) In the Household OCR Excluded Record Types picklist, select any Record Types you want to exclude from automatic Household soft crediting. For example, you might use a different Record Type for children so that you can exclude children from automatic soft crediting whenever a parent makes a donation.
- Click Save.
Enable Contact Role for Organizational Opportunities
For Organizational gifts, you may wish to assign a soft credit to someone who helped you win the gift, for example, a board member. NPSP can automatically credit the Contact named in the Primary Contact field on an Organizational Opportunity.
To use this automated soft credit :
-
Click the NPSP Settings tab. If you don't see the tab, find it in the App Launcher (
). - Click , and then click Edit.
- In the Contact Role for Organizational Opps field, select the Contact Role to automatically assign the Contact listed in the Primary Contact field on an Organizational Opportunity.
- Click Save.
Enable Relationship and Affiliation Soft Credits
NPSP can automatically create soft credits based on Relationship and Affiliation records.
For more information, see Automated Soft Credits.
Create Picklist Values
The Related Opportunity Contact Role field on Relationships and Affiliations has these default values:
- Soft Credit
- Solicitor
- Tribute
Create these values if they aren't already there, and add additional ones if needed.
- From Setup, click the Object Manager tab.
- In the list of objects, click Relationship.
- Click Fields & Relationships.
- Click Related Opportunity Contact Role.
- Click New in the Values section to add picklist values.
- Click Save.
Repeat these instructions for the Affiliation object.
Create Opportunity Contact Roles for Relationship and Affiliation Soft Credits
It's important that the picklist values in Related Opportunity Contact Role on Relationships and Affiliations match the available Opportunity Contact Roles.
- From Setup, enter Contact Roles in the Quick Find box, then click Contact Roles on Opportunities.
- Click New in the Opportunity Contact Role Picklist Values section and add any missing Contact roles.
- Click Save.
Enable Partial Soft Credits
Make sure the Partial Soft Credit object is accessible to all profiles that also have access to Opportunities.
Profiles should be granted the same access to the Partial Soft Credit object as they are granted for Opportunities. For example, this is the System Administrator profile:

Enable Account Soft Credits
Before you can use Account Soft Credits, you need to give users access to the Account Soft Credit object and fields, and add the Account Soft Credit related list to your page layout. You can also optionally add more Account Soft Credit roles.
Account Soft Credits are available as of NPSP version 3.137 (August 2018). If you need help figuring out which version of NPSP you're using, check out Which Version of NPSP Am I Using?.
Give Users Access to the Account Soft Credit Object and Fields
-
Click
, then click Setup. -
In Setup, enter Profiles in the Quick Find box, then click Profiles.
-
Edit the profiles of all users who will work with Account soft credits.
-
Click Object Settings, then click Account Soft Credits.
-
Click Edit and set the object permissions to Read, Create, Edit, and Delete.
-
In the Field Permissions section, select Read Access and Edit Access for each field.
-
Click Save.
Add the Account Soft Credit Related List to Page Layouts
If you started using NPSP from a trial at version 3.137 or later, you can skip this section.
We recommend adding the Account Soft Credit related list to your Opportunity page layouts and the Organization Account page layout.
-
Click
, then click Setup. -
Click the Object Manager tab.
-
In the list of objects, click Opportunity.
-
Click Page Layouts.
-
Click the name of the page layout you want to edit.
-
In the list on the left of the palette, click Related Lists.
-
Find the Account Soft Credits related list and drag it to where you want it on the page.

-
Click Save.
Now, if you go to an Opportunity record, you'll see the Account Soft Credits related list.

Repeat these steps for your other Opportunity page layouts and the Organization Account page layout.
Add More Account Soft Credit Roles
By default, Account soft credits have three default roles: Donation Source, Influencer, and Match. You may need to set up additional roles based on your org and business processes. You create new roles by editing the Role picklist values on the Account Soft Credit object.
-
Click
, then click Setup. -
Click the Object Manager tab.
-
In the list of items, click Account Soft Credit.
-
Click Fields & Relationships.
-
In the list of fields, click Role. Then scroll down to the Values related list.
-
Click New and enter new Role values. Each value should be on its own line.

-
Click Save.

Now you can use these Roles in your Customizable Rollups for Account soft credits. When creating a Customizable Rollup for Account soft credits, be sure to create a filter group with a filter rule that includes these values.

