JustGiving - settings and mappings


For maximum flexibility, there are several ways to configure mappings of JustGiving donation data when it is pulled into Donorfy:

  • Donorfy's main Settings area, i.e. Settings | Configuration | JustGiving Settings
  • Campaign-specific settings in Donorfy, configured via the JustGiving tab for the Campaign
  • For donations made via JustGiving Fundraising Pages, custom codes may be added to the page itself to determine how the page (and its donations) will be mapped into Donorfy

Default settings

Default settings for mapping JustGiving data into Donorfy are made via Donorfy's main settings screen at Settings | Configuration | JustGiving Settings.

The settings configured here include:

  • default transaction mappings for direct donations - i.e. donations not made through a fundraising page - and for fundraising page donations where no campaign-specific mappings have been defined
  • identification of a constituent to be used for mapping donations made anonymously in JustGiving
  • identification of a Purpose to be enabled or disabled according to the fundraiser's or donor's decision to opt in or opt out of further communications

Campaign-specific settings

Fundraising Pages - and therefore donations made through them - may be linked to a Donorfy campaign by using the Settings accessed via the JustGiving tab for the campaign.

The Campaign dropdown will present a list of JustGiving campaigns and appeals identified from Fundraising Pages retrieved. Having chosen a campaign or appeal from this list, any future donations made through pages linked to the same JustGiving campaign or appeal will result in transactions linked to this campaign in Donorfy.

Note though that fundraising pages may still map to a Donorfy campaign via custom code settings made for the page in JustGiving, even where no setting is made via this dropdown in Donorfy. In such a case, the transaction mappings (payment method, product etc) made via this same Donorfy settings view will still apply.

Custom codes on JustGiving Fundraising Pages

JustGiving offers charities the ability to add custom codes to certain data, including fundraising pages - see this article (PDF). Donorfy has adopted the following convention for use of custom codes on fundraising pages, that will control how donations made via these pages are mapped to transactions in Donorfy.

Custom Code 2 - if defined, Donorfy will try to match this value to the name of a Department

Custom Code 3 - if defined, Donorfy will try to match this value to the name of a Campaign

Custom Code 4 - if defined, Donorfy will try to match this value to the name of a Fund

Settings made via custom codes in JustGiving will override any settings made in Donorfy.

Creating a strategy for mapping

We recommend you identify a strategy for mapping donations into Donorfy, and apply the same strategy for all campaigns and fundraising pages.

Any strategy will require default settings to be defined via Settings | Configuration | JustGiving Settings. To supplement this, you might choose only to use custom codes in Fundraising Pages, and not to make use of Campaign-specific settings in Donorfy. Alternatively, you might decide to use Campaign-specific settings in Donorfy, and not to use custom codes.

Have more questions? Submit a request


  • Avatar

    When this page says Custom Code 2-4 does it mean 1-3? I can only add 3 JG custom codes to campaign / fundraiser pages etc.

  • Avatar
    Mike Dillamore

    Custom Codes 2, 3 and 4 is correct. Donorfy will only use custom codes on fundraising pages, and we would expect 6 of these to be available. If the JustGiving article referenced does not help with this, you may need to contact JustGiving support.

Powered by Zendesk