> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wegive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Mapping Overview

> Object-level mapping between WeGive and Salesforce Nonprofit Cloud, with links to field-level reference pages

## Object mapping

| WeGive object | NPC object | Notes |
| - | - | - |
| Supporter (individual) | Account (Person Account record type) | Person Account = Account plus embedded Contact |
| Company | Account (Organization record type) | |
| Household | Account (Household record type) | Members link via `ParentId` |
| Campaign | `Campaign` | |
| Fund | `GiftDesignation` | |
| Transaction | `GiftTransaction` | |
| Fund allocation (transaction) | `GiftTransactionDesignationRelation` | Designation splits |
| Recurring plan | `GiftCommitment` plus `GiftCommitmentSchedule` | Schedule rows define frequency and interval |
| Fund allocation (recurring plan or pledge) | `GiftDefaultDesignation` | Percentage-based |
| Pledge | `GiftCommitment` with `FormalCommitmentType` | |
| Soft credit | `GiftSoftCredit` | |
| Campaign supporter | `CampaignMember` | |
| Transaction refund | `GiftRefund` | |
| Tribute | `GiftTribute` | Child of `GiftTransaction` |

## Field-level reference

<CardGroup cols={2}>
  <Card title="Person Account" href="/external/onboarding/npc/data-mapping/person-account">
    Individual supporter fields.
  </Card>

  <Card title="Organization Account" href="/external/onboarding/npc/data-mapping/organization-account">
    Company fields.
  </Card>

  <Card title="Household" href="/external/onboarding/npc/data-mapping/household">
    Household fields and member linkage.
  </Card>

  <Card title="Gift Transaction" href="/external/onboarding/npc/data-mapping/gift-transaction">
    Transaction fields, status, payment method, designations, tributes.
  </Card>

  <Card title="Gift Commitment" href="/external/onboarding/npc/data-mapping/gift-commitment">
    Recurring plan fields and schedule translation.
  </Card>

  <Card title="Gift Designation" href="/external/onboarding/npc/data-mapping/gift-designation">
    Fund fields.
  </Card>

  <Card title="Soft Credit" href="/external/onboarding/npc/data-mapping/soft-credit">
    Soft credit amount and role.
  </Card>

  <Card title="Pledge" href="/external/onboarding/npc/data-mapping/pledge">
    Pledge fields.
  </Card>

  <Card title="Campaign" href="/external/onboarding/npc/data-mapping/campaign">
    Campaign fields and hierarchy.
  </Card>

  <Card title="Campaign Member" href="/external/onboarding/npc/data-mapping/campaign-member">
    Supporter-to-campaign relationship.
  </Card>
</CardGroup>

## Sync direction legend

| Symbol | Meaning |
| - | - |
| ↔ | Bidirectional |
| → | Push only. WeGive writes to NPC; NPC edits are not pulled. |
| ← | Pull only. NPC writes to WeGive. |
| create-only | Set when the record is first created; not updated afterward. |

## Customizing a mapping

Every default mapping can be overridden per organization under **Mapping Rules** in the integration settings. A rule points a WeGive attribute at an NPC field (standard or custom) and sets its direction. WeGive does not create Salesforce fields; create the field first, then map to it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.