Duplicate Gift Records

Symptoms

Gifts are appearing twice in Virtuous. The same donation shows up as two separate gift records, or new duplicates are created every time the integration syncs.

Root Cause

This is almost always caused by a missing wg_id custom field in Virtuous. WeGive uses this field to track which gifts have already been synced. Without it, WeGive has no way to know a gift already exists in Virtuous, so it creates a new one each time.

How to Resolve

Step 1: Create the wg_id Custom Field

If the field doesn't exist yet, create it now:

1. In Virtuous, navigate to Custom Fields

2. Click Create Field

3. Select Gift as the object type

4. Enter wg_id as the field name (this must be exact)

5. Set the field type to Text

6. Click Save Field

Once this field is in place, WeGive will start writing its transaction ID into it during future syncs, and will check for it before creating new gift records.

Step 2: Clean Up Existing Duplicates

If duplicate gifts were already created before the field was added, you'll need to remove them manually in Virtuous. Review your recent gifts and delete the duplicate entries. The original gifts (the ones that were in Virtuous before the integration was enabled) should be kept.

Step 3: Clear Any Integration Locks

If duplicate gift errors caused integration locks in WeGive:

1. Go to Data > Integration Locks

2. Select the affected records

3. Click Archive to clear the locks

WeGive will automatically retry syncing these records during the next integration cycle. With the wg_id field now in place, the sync should succeed without creating duplicates.

Prevention

Always create the wg_id custom field before enabling the Virtuous integration. This is covered in Prerequisites & Before You Begin.