NPSP extension settings
The NPSP Fundraising & Donations Extension provides comprehensive configuration options to control how fundraising data integrates with your Salesforce NPSP org. These settings allow you to customise data processing behaviour, field mappings, and business logic to match your organisation's requirements.
Settings overview#
- Tab: Fundraising & Donations
- Header: Settings: Fundraising & Donations
- Description: Configure the settings for the MoveData Fundraising & Donations Extension. Supports fundraising and donation activity in Salesforce and used in the following integrations: Facebook, GoFundMe, JustGiving, PayPal Giving Fund, Good2Give, Raisely, Funraisin', Grassrootz, Pixo, Everyday Hero.
Anonymous contact#
Configure handling of donations where donor information is not provided by the fundraising platform.
| Setting | API name | Type | Default | Description |
|---|---|---|---|---|
| Anonymous Contact | Config_AnonymousContactId |
Contact Lookup | null | An anonymous contact is used where the source platform does not provide information on the fundraiser or donor. Specify an anonymous contact to be used across your MoveData integrations (create and then link here if you don't already have one). |
Accounts#
Configure how MoveData processes Organisation Account records into Salesforce.
| Setting | API name | Type | Default | Options | Description |
|---|---|---|---|---|---|
| Disable Platform Key Match | Config_AccountDisablePlatformKey |
Boolean | false | Skip Platform Key / Match on Platform Key | Controls whether MoveData uses platform-specific identifiers to match existing accounts. |
| Disable Salesforce Duplicate Match | Config_AccountDisableDupMatch |
Boolean | false | Skip Duplicate Match / Perform Duplicate Match | Controls whether MoveData uses Salesforce duplicate rules when creating/updating accounts. |
| Skip Type | Config_AccountIgnoreType |
Boolean | false | Skip Type / Set Type | Set this to true if you don't want MoveData to set the Type field when processing Accounts. |
| Use State Code for Address State | Config_AccountUseStateCode |
Boolean | false | Use State Code / Use State Name | Instructs the extension to use the State Code for the Address State field when available. |
| Use Country Code for Address Country | Config_AccountUseCountryCode |
Boolean | false | Use Country Code / Use Country Name | Instructs the extension to use the Country Code for the Address Country field when available. |
| Default Type Value | Config_AccountDefaultType |
String | "Other" | — | Set this value if you want to override the default Type value for Accounts. Defaults to 'Other'. |
Contacts#
Configure how MoveData processes Contact records into Salesforce.
| Setting | API name | Type | Default | Options | Description |
|---|---|---|---|---|---|
| Disable Platform Key Match | Config_ContactDisablePlatformKey |
Boolean | false | Skip Platform Key / Match on Platform Key | Controls whether MoveData uses platform-specific identifiers to match existing contacts. |
| Disable Salesforce Duplicate Match | Config_ContactDisableDupMatch |
Boolean | false | Skip Duplicate Match / Perform Duplicate Match | Controls whether MoveData uses Salesforce duplicate rules when creating/updating contacts. |
| Ignore Address | Config_ContactIgnoreAddress |
Boolean | false | Skip Address / Set Address | Set this to true if you don't want MoveData to set the Address field when processing Contacts. |
| Determine Address Field | Config_ContactUseMailingAddress |
Boolean | true | Mailing Address / Shipping Address | Controls which address field MoveData populates. |
| Overwrite all Address Fields when Updating | Config_ContactAddressOverwriteAll |
Boolean | false | Replace all address fields / Only update fields in notification | When set to true, the street, city, state, postcode and country will be set; if values are missing for these fields, they are set to empty. |
| Ignore Address Fields when not Empty | Config_ContactIgnoreAddressWhenNotEmpty |
Boolean | false | Only set address field when empty / Update address field with changes | When set to true, the address will only be set when there is no pre-existing address. This is useful when you are confident that your address data is likely to be a higher quality than the address data in the notification. |
| Inherit Account Address | Config_ContactAddressInheritAccount |
Boolean | false | Use Address from Account (if missing on Contact) / Do not use Address from Account | Set this to true if you want to use the Address from the Parent Account when there is no address provided as part of the Contact notification. |
| Ignore Phone | Config_ContactIgnorePhone |
Boolean | false | Skip Phone / Set Phone | Set this to true if you don't want MoveData to set the Phone field when processing Contacts. Only set when phone is not null. |
| Skip DoNotContact | Config_ContactIgnoreDoNotContact |
Boolean | false | Skip DoNotContact / Set DoNotContact | Set this to true if you don't want MoveData to set the DoNotContact field when processing Contacts. Only set when newsletter = false. |
| Ignore Email | Config_ContactIgnoreEmail |
Boolean | false | Skip Email / Set Email | Set this to true if you don't want MoveData to set the Email field when processing Contacts. Only set when email is not null. |
| Use State Code for Address State | Config_ContactUseStateCode |
Boolean | false | Use State Code / Use State Name | Instructs the extension to use the State Code for the Address State field when available. |
| Use Country Code for Address Country | Config_ContactUseCountryCode |
Boolean | false | Use Country Code / Use Country Name | Instructs the extension to use the Country Code for the Address Country field when available. |
| Record Protection | Config_ContactProtectLevel |
Select | 1 | See below | If "Protect Name" is checked on the record, the following protections will be applied. |
Record protection levels#
| Level | Description |
|---|---|
| 1 | Protect First Name / Last Name |
| 2 | Protect First Name / Last Name + Email / Address / Phone |
| 3 | Protect Record (No Updates) |
Contact and account formatting#
Configure the formatting for Contacts and Accounts.
Account name casing#
| Setting | API name | Type | Default | Options |
|---|---|---|---|---|
| Account Name Casing | Config_AccountNameCase |
Select | 0 (None) | None (0) / Name Case (1) / Proper Case (2) / Upper Case (3) |
Contact name casing#
| Setting | API name | Type | Default | Options |
|---|---|---|---|---|
| First Name Casing | Config_ContactNameFirstCase |
Select | 0 (None) | None (0) / Name Case (1) / Proper Case (2) / Upper Case (3) |
| Last Name Casing | Config_ContactNameLastCase |
Select | 0 (None) | None (0) / Name Case (1) / Proper Case (2) / Upper Case (3) |
Address casing#
| Setting | API name | Type | Default | Options |
|---|---|---|---|---|
| Address Street Name Casing | Config_ContactAddressStreetCase |
Select | 0 (None) | None (0) / Name Case (1) / Proper Case (2) / Upper Case (3) |
| Address City Casing | Config_ContactAddressCityCase |
Select | 0 (None) | None (0) / Name Case (1) / Proper Case (2) / Upper Case (3) |
| Address State Casing | Config_ContactAddressStateCase |
Select | 0 (None) | None (0) / Name Case (1) / Proper Case (2) / Upper Case (3) |
| Address Country Casing | Config_ContactAddressCountryCase |
Select | 0 (None) | None (0) / Name Case (1) / Proper Case (2) / Upper Case (3) |
Advanced formatting options#
| Setting | API name | Type | Default | Options | Description |
|---|---|---|---|---|---|
| Apply case formatting when mixed case is provided by source platform | Config_AdvancedIgnoreMixedCase |
Boolean | false | Do not apply case changes when mixed case is provided by the source platform / Always apply case changes | Only applies to Name Case and Proper Case changes. If Upper Case is selected this toggle will be ignored. |
Campaigns#
Configure how MoveData processes Campaign records into Salesforce.
| Setting | API name | Type | Default | Options | Description |
|---|---|---|---|---|---|
| Ignore Campaign Name | Config_IgnoreCampaignName |
Boolean | false | Skip Generated Campaign Name / Set Generated Campaign Name | Set this to true if you don't want MoveData to set the Name field for a Campaign. Toggle this when you set this using other rules such as Apex triggers. |
| Suppress Campaign Status generation | Config_IgnoreDefaultCampaignStatus |
Boolean | false | Do not generate Status / MoveData to determine Status | Controls whether MoveData generates Campaign Status values. |
| Ignore Type | Config_IgnoreDefaultCampaignType |
Boolean | false | Skip Type / Set Type | Set this to true if you don't want MoveData to set the Type field when processing Campaigns. |
| Default Type Value | Config_CampaignDefaultType |
String | "Other" | — | Set this value if you want to override the default Type value for Campaigns. Defaults to 'Other'. |
Donations#
Configure how MoveData processes Opportunity records into Salesforce.
| Setting | API name | Type | Default | Options | Description |
|---|---|---|---|---|---|
| Donation Name Pattern (Account Donor) | Config_DonationNameAccount |
ASCII | {!Account.Name} {!Amount} {!RecordType.Name} {!CloseDate} |
— | If NPSP Opportunity Names are configured, then this pattern will be overwritten. |
| Donation Name Pattern (Contact Donor) | Config_DonationNameContact |
ASCII | {!Contact.Name} {!Amount} {!RecordType.Name} {!CloseDate} |
— | If NPSP Opportunity Names are configured, then this pattern will be overwritten. |
| Ignore Offline Donations | Config_IgnoreOfflineDonations |
Boolean | true | Do not process Offline Donations / Create Offline Donations | When set to true, MoveData will not create any entries in Salesforce for Offline Donations. An offline donation is often used by fundraising platforms to support recording transactions completed off-system, ensuring the overall total listed reflects a complete campaign. |
| Ignore Failed Donations | Config_IgnoreFailedDonations |
Boolean | true | Do not process Failed Donations / Create Failed Donations | When set to true, MoveData will not create any entries in Salesforce for Failed Donations. |
| Do not mark as Private | Config_DonationSetAnonymousAsPrivate |
Boolean | true | Mark as Private / Do not mark as Private | Controls whether anonymous donations are marked as private. |
| Create Soft Credit | Config_DonationOpportunityContactRoleSoftCredit |
Boolean | true | Create Opportunity Contact Role (Soft Credit) / Do not create Soft Credit | Controls whether MoveData creates soft credit records. |
| Subtract Platform Fee from Amount | Config_DonationAmountSubtractFeePlatform |
Boolean | false | Subtract Platform Fee from Amount / Use Amount as provided | If set to true, the Public Platform Fee will be subtracted from the Amount. If this is unavailable, the Total Platform Fee will be substituted. |
Recurring donations#
Configure how MoveData processes Recurring Donation records into Salesforce.
| Setting | API name | Type | Default | Options | Description |
|---|---|---|---|---|---|
| Ignore Date Established when not Empty | Config_RecurringIgnoreDateEstNotEmpty |
Boolean | false | Only set Date Established field when empty / Update Date Established field with changes | Controls whether MoveData updates the Date Established field when it already has a value. |
| Ignore Effective Date when not Empty | Config_RecurringIgnoreStartDateNotEmpty |
Boolean | false | Only set Effective Date field when empty / Update Effective Date field with changes | Controls whether MoveData updates the Effective Date field when it already has a value. |
| Disable Day of Month | Config_RecurringSuppressDay |
Boolean | false | Skip Day of Month / Set Day of Month | Controls whether MoveData sets the Day of Month field. |
| Disable Next Payment Date | Config_RecurringSuppressNextPayment |
Boolean | false | Skip Next Payment Date / Set Next Payment Date | Controls whether MoveData sets the Next Payment Date field. |
| Days Offset for matching to Opportunities | Config_DonationRecurringOffsetDays |
Number | 5 | Range: 1–30 | Used to determine how many days to offset when matching to existing opportunities owned by a recurring donation. |
Campaign members#
Configure how MoveData processes Campaign Member records into Salesforce.
| Setting | API name | Type | Default | Options | Description |
|---|---|---|---|---|---|
| Create Fundraising-specific Campaign Members | Config_CreateCampaignMembers |
Boolean | true | Generate Campaign Members / Do not create Campaign Members | Set this to false if you wish to skip MoveData creating fundraising-specific campaign members. You may need to disable this if you are getting issues; these can be caused by other logic and apps that manipulate Campaign Members. |
| Delete existing Campaign Member statuses | Config_CampaignMemberDeleteExistingStatuses |
Boolean | false | Use only MoveData-provisioned Campaign Member statuses / Co-exist with existing Campaign Member statuses | Set this to true if you wish to only have MoveData-determined Campaign Member Statuses for fundraising campaigns. If you have statuses for particular reasons, like integrations with marketing tools such as Pardot or Marketing Cloud, you may want to set this to false to retain previously mapped statuses. |
Opportunity contact roles (soft credits)#
Configure how MoveData works with Opportunity Contact Roles, used for Soft Credits. This logic runs in addition to the soft credit records created by the Non-Profit Success Pack.
| Setting | API name | Type | Default | Description |
|---|---|---|---|---|
| Create Soft Credits | Config_DonationOpportunityContactRoleSoftCredit |
Boolean | true | Set this to false if you wish to skip MoveData creating fundraising-specific soft credits. |
| Soft Credit Role for Top-Level Campaign | Config_DonationSoftCredit_Role_Campaign |
String | "Soft Credit" | If a top-level campaign in a MoveData notification has a primary contact, then a soft credit will be created against the opportunity. |
| Soft Credit Role for Team | Config_DonationSoftCredit_Role_Team |
String | "Soft Credit" | If a team campaign in a MoveData notification has a primary contact, then a soft credit will be created against the opportunity. |
| Soft Credit Role for Fundraiser | Config_DonationSoftCredit_Role_Fundraiser |
String | "Soft Credit" | If a fundraiser campaign in a MoveData notification has a primary contact, then a soft credit will be created against the opportunity. |
Related article
For more information on how soft credits work in MoveData, see Your data in NPSP.