Skip to main content

How to: Add and use Custom Calculated Fields

  • January 21, 2025
  • 3 replies
  • 45 views

Happie Pingol
Forum|alt.badge.img+1

Attention: EveryAction is now Bonterra CRM. Please bear with us as we update our screenshots to match our new name.
(7 min read)

Custom Calculated Fields allow you to create your own contribution summary fields you can use to track things like the count, average amount, total amount, highest previous amount, or most recent date. These fields are available to anyone using the Development Pro package.

 

These fields are automatically added to the Custom Calculated Fields group, rather than one of your Contact Custom Field groups.

Read more about creating other kinds of custom fields
 

Creating Custom Calculated Fields

Begin by searching for the Custom Fields list from the Sidebar.



To add your new field, select Create New Custom Field > Calculated Field.

Custom Field dropdown menu with Calculated Field highlighted


You can then add the Field Details, such as name and description.
Entry fields for details


Selecting the type and range

On the Type & Range step, you'll be able to add the type of calculated field, specify whether it should be calculated based on individual or financial household giving, and select the date range to use for your calculations.

Type & Range step on calculated field

The Field Type can be either:

  • a Count of contributions - count of contributions that meet the critera

  • a calculated Amount, of one of these types:

    • Average - average gift amount of all contributions that meet the criteria

    • Highest - highest gift amount of all the contributions that meet the criteria

    • Total - sum of all contributions that meet the criteria

    • Most Recent - the most recent gift of all the contributions that meet the criteria

    • Comparison - the difference between the sum of gifts in one date range and the sum of gifts in another date range

 

Comparison fields, in particular, can help you see if giving is increasing or decreasing, by showing the change amount, the percentage difference between base amount and comparison amount, and a status indicating the nature of the change, including:

  • Upgraded: when the Base amount is less than the Comparison amount

  • Level: when the Base amount is equal to the Comparison amount

  • Downgraded: when the Base amount is greater than the Comparison amount

  • New or Reactivated: when the Comparison amount is greater than the Base, but the Base is zero

  • Lapsed: when the Base amount is greater than the Comparison but the Comparison is zero

If giving in both the base and comparison period is zero, then the values for this field will be blank for that person.

 

For the audience, you can select whether you only want to use contributions given by the individual or whether you want to include all members of the household when you make your calculation. You might, for example, find it more useful to calculate the most recent contribution or highest previous contribution for the entire household which can then be included as a custom calculated field on each family member’s contact records.

 

When selecting a Date Range, you can use This year or Last year to create a dynamic range that won’t require you to update the field at the start of every year.

 

Adding more details

On the Contribution Details step, you can further refine the universe of contributions you want to include in your calculations.

 

You can choose which Designations to include in your custom calculated field, by filtering contributions to a single designation for this calculation or by using the contributions that meet your criteria from multiple Designations that you specify.



You can select if you want to include recurring contributions in your calculation. For example, if you are creating a field that identifies the Highest contribution amount over a certain time period, limiting the universe to recurring contributions in your calculations will show you the highest recurring amount from that person rather than their highest one-time amount.

 

If you select only recurring contributions as your universe, you can further narrow your choice to include only the frequencies you’re interested in.

Frequency dropdown shows monthly and weekly selected as well as other available options

You can select whether you want to include attributed contributions in your calculations.
Select buttons for only direct, only attributed, or both
You can also select which Soft Credit types you want to include in your Attributed contributions. For instance, if a person has a soft credit for a donor-advised fund gift, that will be included towards the sum of gifts, as part of a comparison, or returned as the Most Recent Contribution or Highest Previous Contribution, even though it’s not a direct gift from the donor.
A dropdown list of attribution types

You can then decide whether to include pledges in your calculations or not.
Selectors for Received or Committed funds
If you select the Committed option, bookable pledges (those that are marked to give/unconditional/promise) will be included in your amounts or contribution counts but the payments on the pledge ARE NOT included in the calculation. If you select Received, pledges will not be included in the summary fields.
 

Filtering contributions

In the Filters step, you can choose to include or exclude contributions with specific campaigns, channels, source codes, payment methods, or custom contribution fields. Organizations with disclosure reporting will also see Period and Cycle options.

Examples of various filters being used (campaign with polar bears and source code of endangered species)

Using the filters, for instance, you can include or exclude contributions to a particular campaign (or group of campaigns) as part of your calculation. Or, you can exclude in-kind gifts by selecting Exclude Only > Payment Method > In-Kind. You can also use the Channel filter to exclude contributions made via offline channels if you want to calculate the highest amount for each contact in your online channels.


Reviewing your settings

In the final step, you can Review and Edit all your details and filters and make any edits before you Save & Finish. After you are finished, your new field will appear in the list under the Custom Calculated Fields Group.
example list of calculated fields

Once you’ve added the field, it will calculate and populate the values for all the existing donors in your database. After the initial calculation is added, the values going forward won’t update immediately when new gifts are entered. Instead, your calculated fields will update once a day during an overnight process.


Viewing on contact records

After adding your Custom Calculated Field, you can see the results on the Financial tab of an individual contact record.

Financial Tab, Custom Calculated Fields

Comparison fields will appear with an Amount, a Percent Change, and a Status (see above for an explanation of Status.)

If the calculated field is based on giving from the entire Financial Household, you’ll see them noted with the house icon.

Financial Households Totals (House icon)

Searching on Custom Calculated Fields

You can use your Custom Calculated Fields to make a list of contacts by using them as criteria from the Custom Contact Fields section of Create a List.
Example of searching on custom calculated fields

Custom Calculated Fields of the type Total or Average will display with a single range selector for an amount.
Amount range selector (from - to)

If your Custom Calculated Field is one that identifies the highest or most recent contribution, you will see an amount selector but you will also see a date range selector.
Example of an HPC with a date range selector

Custom Calculated Fields that use comparisons will have selectors for choosing an Amount range, a range for percent change, and an option to select one or more statuses.
Example of a comparison fields with amount, percentage, and status


Adding to reports 

You can also include your Custom Calculated Fields as additional columns in many of your reports, including:

  • Attributions & Soft Credits Report

  • Changes to Contact Records Report

  • Contribution Aggregate Report

  • Membership Report


Custom calculated fields highlighted in columns list

When you add a highest or most recent type calculated field, you will see a column for amount and one for date for each field. If you add comparison type Custom Calculated Fields to your report, you will see separate Amount, Percentage, and Status columns for each field.
Example of Contributtion Aggregate report with additional columns


Exporting with your list

You can add Custom Calculated Fields to any list you plan to export by customizing the Standard Text Export.

Read more about exporting lists
 

From My List, select Export > Standard Text > Customize Export.
Standard Text Export selected and Customize Export button is highlighted

From the Fields to Export section, use the dropdown to search for Custom Calculated Fields.
 

Selecting the mapping for Custom Calculated fields
 

You can then find the specific fields you want to include.
Selecting the desired custom calculated field from the dropdown to include in the export

Multiple columns will be added to your report for any comparison fields you add, including one for amount, one for percentage, and one for status. Any highest or most recent type Custom Calculated Fields will have columns for amount and date.

Highlighting the additional columns in a report


 

Exporting in Direct Response Plans

You can also add Custom Calculated Fields to your Direct Response Plan exports.
Read more about customizing and exporting your Direct Response Plan

When you are ready to export your approved plan, select Customize Export.

Customize Export button highlighted in an export of a Telemarketing plan
 

From the Fields to Export section, use the dropdown to search for Custom Calculated Fields and after you add it, use the dropdown to search for the specific field you wish to add.

Selecting the desired custom calculated field from the dropdown to include in the export

3 replies

Forum|alt.badge.img
  • First Timer
  • February 2, 2026

Thank you for the overview!  I have created a Custom Calculated Field, but would like to review and update some of the settings.  I’m able to find it listed under the Administration > Custom Fields > Custom Field Groups > Custom Calculated Fields page, but there is no way to view or edit the details.  How can that be accomplished?


Forum|alt.badge.img

Hi ​@jjonik! As long as you are in the committee where the field was created and are able to get to the Custom Calculated Fields page (which sounds like you can) you should be able to either click on the name of the field itself or click the three dots on the far right side of the table and select edit. 

If you are unable to do either of these things, there may be something specific about your field or permissions that our support team will need to take a look at. I would reach out to them about which field you are trying to make edits to, so they can use that info (and your user/committee info) to look into your case.


Forum|alt.badge.img
  • First Timer
  • February 2, 2026

Hi Jasmine - I don’t see the three dots and when hovering over all text, there are no links so clicking on text does nothing.  I’ll reach out to the support team. Thanks for your help!