FundraisingConfig Metadata Type in SFDX

Architectural Overview#

FundraisingConfig is a core operational metadata type in the next-generation Salesforce Nonprofit Cloud platform (built natively on the core Salesforce data model). In nonprofit organizations, higher education institutions, and philanthropic foundations, fundraising operations require strict accounting discipline, transparent audit trails, and automated gift batch processing.

FundraisingConfig governs global operational policies for philanthropic campaigns, pledge fulfillment schedules, donor allocation rules, and gift entry batches. By codifying these financial and operational settings in Salesforce DX, architecture teams ensure that compliance safeguards—such as preventing gift over-allocations across capital campaigns or enforcing fiscal accounting rules—remain uniform across development, staging, and production orgs.

Directory and File Conventions#

In Salesforce DX source format (apiVersion 68.0), FundraisingConfig components are stored in the fundraisingConfigs/ directory.

Key Metadata Fields#

The FundraisingConfig XML schema exposes configuration flags for batch processing and allocations:

Declarative XML and Package Manifest Examples#

Below is a declarative FundraisingConfig establishing financial compliance controls for an enterprise nonprofit:

<?xml version="1.0" encoding="UTF-8"?>
<FundraisingConfig xmlns="http://soap.sforce.com/2006/04/metadata">
    <developerName>Default_Enterprise_Fundraising</developerName>
    <masterLabel>Default Enterprise Fundraising</masterLabel>
    <enableGiftBatchProcessing>true</enableGiftBatchProcessing>
    <enablePledgeSchedules>true</enablePledgeSchedules>
    <allowOverAllocation>false</allowOverAllocation>
</FundraisingConfig>

Package Manifest (package.xml)#

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>Default_Enterprise_Fundraising</members>
        <name>FundraisingConfig</name>
    </types>
    <version>68.0</version>
</Package>

CLI Retrieval and Deployment Commands#

Manage FundraisingConfig definitions via the Salesforce CLI:

# Retrieve fundraising configuration settings
sf project retrieve start --metadata FundraisingConfig

# Deploy fundraising settings to your nonprofit scratch org
sf project deploy start --metadata FundraisingConfig:Default_Enterprise_Fundraising

Architect Best Practices and Gotchas#

• Financial Integrity Safeguards: Keep allowOverAllocation set to false in production environments to maintain GAAP and IFRS non-profit accounting compliance.
• Licensing and Permission Constraints: Users managing gift batches must be assigned the standard Fundraising User permission set license in addition to standard object permissions.
• Data Migration Sequencing: Ensure FundraisingConfig is committed and active before loading historical gift batch records or recurring donation schedules.

Frequently asked questions

What enterprise capability does FundraisingConfig provide in Nonprofit Cloud?

It standardizes high-volume gift batch processing, automated pledge schedules, and donor accounting logic across non-profit enterprise instances.

What licensing feature is required before deploying FundraisingConfig?

The target org must have Nonprofit Cloud and Fundraising permissions enabled in licenses or scratch org definitions prior to deployment.

How does FundraisingConfig safeguard financial allocation integrity?

It enforces rules preventing gift over-allocations and ensures donor contributions balance exactly against campaign accounting general ledger codes.