Skip to main content

List Types

Learn about the different List Types in Donorfy, what data each one works with, and how to use them for querying, segmenting, and reporting.

Cristina Gruita avatar
Written by Cristina Gruita
Updated yesterday

Overview

Lists let you search and report on different areas of data in Donorfy, including:

  • Constituent data – people and organisations and their relationships.

  • Financial data – transactions, recurring payments, memberships, pledges, opportunities.

  • Timeline data – activities and Gift Aid declarations.

  • Other data – change logs and (for some accounts) custom list views.

At the top level, List Types group like this:

Constituent data

Financial data

Timeline data

Other

Members List

Soft Credit List

Activity List

Campaign List

Constituent List

Membership List

Gift Aid Declaration List

Fundraising Page List

Constituent Tag List

Transaction List (ALL / Payment / Allocation)

Change Log List

Connection List

Recurring Payment Instruction List

Custom List Views*

Recurring Payment Beneficiaries List

Opportunity List

Opportunity Pledges (Pledge List)

* Custom List Views are only available for Professional – Own Azure accounts.

Each List Type is explained in more detail below.

For a general explanation of List sections (Details, Filters, Columns, Results) and features shared across all List Types, see Lists Overview.


Constituent Data Lists

Constituent List

A Constituent List lets you query and report on information directly from a constituent’s profile, including:

  • Contact details.

  • Tags.

  • Communication channels and purposes.

  • Financial summary data.

Typical uses:

  • Building campaign segments.

  • Creating mailing / email lists.

  • Finding specific people or organisations (e.g. lapsed donors, major donor prospects).

Constituent Lists are also used as the basis for syncing data to Mailchimp (for example in the “Step 5: Updating Mailchimp from Donorfy” process).

Creating a Constituent List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Constituent List.

  3. Enter a description (List name).

  4. Click Add.

Your List will open, showing:

  • Details.

  • Filters.

  • Columns.

  • Results.

You can now add filters and columns to answer your question.

Showing a Constituent List in the Menu

You can choose to show a Constituent List under the main Constituents menu:

  1. In the List, go to the Details section.

  2. Toggle Show in Menu to Yes.

  3. Save the List.

The List will then be visible as a sub-menu item under Constituents in the left-hand navigation (click the plus to reveal lists).

You can also restrict who sees the List in this menu:

  1. Still in Details, find Which users can see?

  2. Click into the drop-down to see users who have access to Lists.

  3. Select one or more users to allow them to see this List in the menu.

  4. Click Save List and Fetch Results.

Only the selected users will see this List in the menu.

Pre-filter by Channels and Purposes

If you’re building a List for communications, you can quickly apply consent checks without building complex filters.

In the Filters section you’ll see pre-filter options:

  • Channels – choose one or more communication channels (e.g. Email, Post).

  • Purposes – choose one or more communication purposes.

To use:

  1. Click into the Channels box and select the channels you require.

  2. Click into the Purposes box and select the purposes you require.

Only constituents who meet both conditions (Channel AND Purpose) will be included in the results.

This is a fast way to ensure your List honours consent without manually adding multiple filter criteria.

Including Archived Constituents

You can include archived constituents in your List:

  1. In Details, set The List should include archived Constituents to Yes.

  2. Save and Preview.

Archived constituents will now be included.

If you want to limit by reason for archiving, add the ArchivedReason field as a filter and specify the reason(s) you are interested in.

Download Options (Constituent Lists)

When you download a Constituent List, you will see standard options plus some additional, constituent-specific options:

  • Create separate files for each communication channel

    Creates separate CSV files per channel found in the List results.

  • Combine people at the same address into one row

    If people are linked to another constituent’s address, only one row per address will be included in the download.

    The address, label name, and salutation from the linked address are used.

  • Use Alternate Label Name and Salutation

    Uses alternate label and salutation in your download.

    You must include the Alternate Salutation and Alternate Label Name columns in your List for this option to appear.

  • Add Activities to Timeline

    Creates a new Activity on the Timeline for every constituent in the List.

    When selected, you will be asked for:

    • Activity Date

    • Campaign

    • Activity Type

    • Notes

    • This is a powerful time-saver for logging bulk actions.

Undoing Activities Added by a List

If you accidentally add Activities via a List:

  1. Go to Home, then click My Downloads.

  2. Locate the relevant List download.

  3. Click the description to open the pop-up.

  4. Click Undo Activities.

The Activities created by that download will be removed.

Mailchimp Updates Tab

Use the Mailchimp Updates tab on a Constituent List when syncing to a Mailchimp audience.

(See the dedicated Mailchimp integration article for configuration and usage details.)

Dotdigital Sync Tab

Use the Dotdigital Sync tab on a Constituent List when syncing to a Dotdigital list.

(See the Dotdigital integration article for more information.)


Constituent Tag List

A Constituent Tag List lets you report on Tags themselves and the extra data stored in them, such as:

  • Tag Start Date / End Date.

  • Campaign linked to the Tag.

  • Whether it is an Excluded Tag.

  • Notes.

  • Custom Fields on the Tag.

Unlike a Constituient List (which asks “who has this Tag?”), a Constituent Tag List is Tag-centred: it looks at data from the Tag’s perspective and returns one row per Tag that matches your filters.

Because of that:

  • A constituent with five Tags could appear five times in the results (once for each Tag).

To get the data you need, add filters that focus on the Tags of interest (for example: “Tag = Finance”).

Please note

  • Only constituents who have a Tag will appear in a Constituent Tag List.

  • You cannot use filters like “has none of the following” because there is no Tag record to match if the constituent does not have that Tag.

You can still use other constituent-based fields in the filters (e.g. permitted channels), which allows you to build Tag-based mailing lists that respect consent.

For more about how Tags work, see Tags Overview.

Creating a Constituent Tag List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Constituent Tag List.

  3. Enter a description (List name).

  4. Click Add.

You can then add filters and columns as required.

Downloading and Adding Activities

When you download a Constituent Tag List you can also:

  • Add Activities to Timeline – works the same way as for Constituent Lists:

    • Creates an Activity for each distinct constituent in the List.

    • Prompts for Activity Date, Campaign, Activity Type, and Notes.

If Activities were added in error, use the Undo Activities option from Home > My Downloads as described earlier.


Connection List

A Connection List helps you find and understand the links between constituents.

Connections are:

  • User-defined links added to constituent profiles (e.g. “Employs”, “Works for”, “Trustee of”).

  • Reciprocal – the connection appears on both constituent profiles.

A Connection List returns both sides of each connection and indicates which side each row relates to:

  • From Constituent.

  • To Constituent.

Filters also have From and To variants so you can specify which side you’re interested in.

Example

To find all constituents who are employed by a company:

  • Use a Connection List with a filter like:

    • Connection Type = Employs.

In results:

  • From Constituent = Company (e.g. Acme Ltd).

  • To Constituent = Employee (e.g. Bugs Bunny).

If you switch the Connection Type to the reciprocal, for example Works for:

  • From Constituent = Bugs Bunny.

  • To Constituent = Acme Ltd.

Information Available in a Connection List

You can include:

  • Contact details (email, address, phone) for both sides of the connection.

  • Connection dates (to find connections active between particular dates).

  • Connection Strength.

  • Connection notes.

  • Prospect research information for both constituents.

  • Financial summary details for both sides.

Connection Strength

Connection Strength indicates how warm or strong the relationship is (on a scale of 1–5).

Fields include:

  • Connection Strength

  • Connection Strength 1 (records the same value as Connection Strength)

You can define your own meaning for each level (e.g. 1 = “cold”, 5 = “warm champion”).

Creating a Connection List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Connection List.

  3. Enter a description (List name).

  4. Click Add.

You can then add Connection Type filters and other conditions.

Mailing from a Connection List

You can obtain contact details from a Connection List, but keep in mind:

  • Contact preferences in the data selection only relate to the From constituent.

  • Contact preferences for the To constituent are not available directly in a Connection List.

To mail the “To” side safely:

  1. Build your Connection List with Connected To Number (or equivalent) in the columns.

  2. Download the List.

  3. Use the File Uploader to add a Tag to the “To” constituents using the Connected To Number.

  4. Create a Constituent List filtered by that Tag.

  5. Use the Constituent List for your mailing and permission checks.

Adding and Deleting Tags from a Connection List

Within a Connection List you can add Tags to constituent profiles. The Tag will be applied to the From Constituent only.

To Tag the To constituents:

  1. Include the Connected To Number in your List results.

  2. Download the List.

  3. Use the File Uploader to add a Tag to those constituent numbers.

For full details, see Adding or Deleting a Tag from all Constituents on a List.


Financial Data Lists

Transaction Lists

A Transaction in Donorfy consists of two halves:

  • The Payment (e.g. £100 received)

  • One or more Allocations (e.g. £70 Donation + £30 Subscription)

Each part (Payment and each Allocation) appears as a separate row in Transaction-based Lists, with its own Transaction Number.

The Transaction Number for the Payment is the same ID shown on the Constituent Timeline.

There are three Transaction List types:

  • Transaction All List.

  • Transaction Payment List.

  • Transaction Allocation List.

Each type shows a different view of the Transaction.

Transaction All List

This is the most flexible Transaction List type because it can show both halves of the Transaction in one place.

Use it when you need to:

  • See full detail for both Payment and Allocations

  • Build complex queries across both sides

If you want to limit the List to just Payments or just Allocations, add a Type filter:

  • For Payments:

    • Type = Payment.

  • For Allocations:

    • Type = Allocation.

If you don’t filter by Type:

  • A donation with one allocation will return 2 rows (one Payment row + one Allocation row).

  • A split gift with two allocations will return 3 rows, and so on.

📌Note: Transaction All Lists are also used as Conditions for Triggers.

  • When using a Transaction All List as a Trigger condition, you must ensure that only one half of the Transaction is included (either Payments or Allocations) by filtering on Type.

Other key points:

  • Payment rows do not contain Allocation-specific data (e.g. Allocation Amount, Allocation Transaction Number).

  • Allocation rows do not contain the Payment Transaction Number.

  • The financial fields such as Amount, Processing Costs, and Gift Aid Amount Claimed are held at the Payment level and are not apportioned across Allocation rows.

Transaction Payment List

A Transaction Payment List returns Payment header details only.

Use it when you want to:

  • Report on payments received without drilling down to Allocation-level detail.

Because it only returns Payments:

  • It should not be used to report on Allocation-specific items such as:

    • Fund.

    • Allocation Amount.

    • Department.

    • Accounting Date.

    • Date Due.

If you add Allocation-related fields to the filters or output:

  • The List will only be able to reference the first or most recently added Allocation, which may not match your expectations.

A Transaction Payment List also cannot:

  • Report on the number of Allocations that make up each payment.

Transaction Allocation List

A Transaction Allocation List returns Allocation-level detail. Use it when you need more granular reporting, for example at Fund level.

Key behaviour:

  • The List includes both Allocation data and the Payment header fields.

  • If a Payment has multiple Allocations, the Payment header data is repeated for each Allocation.

    • Example: A £2.50 processing fee on a Payment with two Allocations will show as £2.50 on both Allocation rows.

Because of that, if you need to apportion Processing Costs or Gift Aid Amount Claimed by allocation:

  • You will need to export to Excel and calculate per Allocation manually.

A Transaction Allocation List cannot report the Payment Transaction Number directly, so to correlate allocations back to the Payment, you may need to use other fields such as Accounting Date and Date Paid.

Creating a Transaction List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select:

    • Transaction All List, or

    • Transaction Payment List, or

    • Transaction Allocation List.

  3. Enter a description (List name).

  4. Click Add.

You can then configure filters and columns.

Please note
Some allocations belong to transactions or recurring payment instructions with a beneficiary – indicating which constituent benefits (e.g. a gift membership).

  • The gift appears on the payer’s timeline.

  • The beneficiary is the person who receives the benefit.

  • The field Is Gift = Yes indicates that the person shown is the beneficiary.

Adding and Deleting Tags from a Transaction List

Within Transaction Lists, you can also add Tags to constituent profiles based on the List results.

For detailed steps, see Adding or Deleting a Tag from all Constituents on a List.


Recurring Payment Instruction List

A Recurring Payment Instruction (RPI) List lets you view financial, statistical, and constituent data related to each recurring payment instruction. Memberships are also represented as RPIs, so membership data can be reported from here too (as well as via the dedicated Membership List).

You can use an RPI List to:

  • Identify regular donors.

  • Find missed or overdue payments.

  • Analyse performance by Campaign, Fund, Channel, Product.

  • Estimate expected income.

Sometimes you may need to combine this data with other detail (e.g. linked Transactions or Connections). In those cases, export as CSV and use Excel for more complex analysis.

Example Uses

Find all constituents who donate regularly (via RPIs)

  • If you primarily use RPIs, create a Recurring Payment Instruction List and add a Tag to all constituents in the List.

  • Set the Tag as an AutoTag so that new regular donors are automatically updated overnight.

  • For recurring donations not linked to RPIs, use a Transaction List where the Payment Method is set to a recurring method (see Payment Methods).

Find everyone who missed a payment this month / last month

  • Filter by:

    • LastPaymentMissedYear = year of interest

    • LastPaymentMissedMonth = month (stored as numbers: 1 = January, 2 = February, etc.)

Find everyone who has missed payments

  • Filter:

    • Status = Overdue

Find recurring payment instructions ending on a certain date

  • Filter using AllocationEndDate for the date (or date range) you are interested in.

  • If an instruction has multiple payments running, this will be the date of the first one to finish.

Send membership packs or information to current members due this month

  • Filter:

    • Status = Active

    • StartMonth = the month you are interested in

Send a thank-you to regular donors

  • Filter:

    • Status = Active

    • Optionally refine by StartMonth or PaymentFrequency (e.g. monthly donors).

Thank people who have recently started giving regularly

  • Filter by DateAdded to find newly created RPIs (e.g. “is in this month”).

Analyse campaigns, funds, channels, products

  • One recurring payment instruction can contain multiple payments and allocations.

  • In an RPI List:

    • Campaigns, Channels, etc. are stored in comma-separated lists.

    • Payment and allocation amounts are stored in PaymentsBreakdown and AllocationsBreakdown (also comma-separated).

  • Export to Excel and use its tools to further analyse breakdowns.

Work out expected income

  • Filter:

    • Status = Active

  • Use the Amount and PaymentFrequency (monthly, yearly, etc.) to estimate income.

  • For more detailed cashflow planning, export to Excel and use StartMonth and other fields to model month-by-month.

Find recurring payment instructions that have been cancelled

  • Filter on Cancel Date.

  • Use a set date range or dynamic dates (e.g. “is today”, “is in this month”).

Creating a Recurring Payment Instruction List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Recurring Payment Instruction List.

  3. Enter a description (List name).

  4. Click Add.

Then add filters and columns as needed.

Adding and Deleting Tags

You can add Tags to constituent profiles from an RPI List. For full details, see Adding or Deleting a Tag from all Constituents on a List.


Recurring Payment Instruction Beneficiary List

A Recurring Payment Instruction Beneficiary List shows data where one constituent pays for something that another constituent benefits from (e.g. gifted memberships, sponsored adoptions).

The List includes:

  • Contact details for both the payer and the beneficiary.

  • Key details of the RPI (e.g. Product, Fund).

This is ideal for mailings to the beneficiary based on RPI characteristics – for example:

  • Sending updates about a sponsored animal, child, project, etc.

📌Note:

  • Sometimes, the beneficiary is the payer.

  • If you want to find RPIs where the beneficiary and payer are different, export to Excel and filter accordingly.

Creating a Recurring Payment Instruction Beneficiary List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Recurring Payment Instruction Beneficiary List.

  3. Enter a description (List name).

  4. Click Add.

Add filters and columns as needed.

Adding and Deleting Tags

You can add Tags to constituent profiles from a Beneficiary List. For full details, see Adding or Deleting a Tag from all Constituents on a List.


Membership List

A Membership List is similar to the Recurring Payment Instruction List but with additional fields specific to Memberships.

It includes, for example:

  • Member Contact Details.

  • Payer Contact Details.

  • Membership Custom Fields.

  • Gift Membership indicator.

  • Member Count.

  • Membership Started On date.

  • Paid Up To date.

  • Membership Status.

You can use this List to see who holds which membership, who pays for it, and key membership dates.

Custom Fields in Membership Lists

Membership custom fields appear as generic names such as:

  • Text1, Number1, Yes/No1, etc.

This is because a Membership List may include multiple Products, and the List cannot know which custom fields apply to which Product at query time.

Creating a Membership List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Membership List.

  3. Enter a description (List name).

  4. Click Add.

Add filters and columns as needed.

Adding and Deleting Tags

You can add Tags to constituent profiles from a Membership List – for example, tagging current members. See Adding or Deleting a Tag from all Constituents on a List for details.


Members List

A Members List focuses on the individual named members within a Membership.

  • Where the member has a Constituent profile, full contact details are available.

  • Where they do not, only basic member details are returned.

  • The List also includes key details of the membership and membership custom fields.

Custom fields behave as with Membership Lists:

  • They are named Text1, Number1, Yes/No1, etc., rather than their configured labels.

Creating a Members List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Members List.

  3. Enter a description (List name).

  4. Click Add.

Add filters and columns as needed.

Adding and Deleting Tags

You can add Tags to constituent profiles from a Members List (for example, tagging individual members). See Adding or Deleting a Tag from all Constituents on a List for the process.


Opportunity List

An Opportunity List provides reporting on both financial and non-financial data for Opportunities, such as major gifts or corporate asks.

Use it to:

  • Report on Forecast Amount for particular types (e.g. Corporate Asks).

  • Summarise Opportunities by Stage.

  • Create mailings for Opportunities in a particular Stage.

  • Find all Opportunities in a particular year.

Examples of Opportunity-specific fields:

  • Application Deadline Date.

  • Ask Amount.

  • Campaign.

  • Closed Date.

  • Current Stage.

  • Days to Close.

  • Description / Opportunity Description.

  • Entity / Entity Number / Entity Sub Type.

  • First Pledge Expected / First Pledge Paid.

  • Forecast / Forecast Amount.

  • Is Non Financial.

  • Last Pledge Expected / Last Pledge Paid.

  • Number / Number Of Pledges / Number Of Pledges Paid.

  • Opportunity Contact / Opportunity Contact Number.

  • Opportunity Date / Opportunity Number / Opportunity Type.

  • Outcome.

  • Selected Items.

  • Total Pledged / Total Pledges Paid.

  • Type.

You can also include constituent details such as:

  • Contact details.

  • Preferences.

  • Prospect research information.

  • Giving summary stats.

Creating an Opportunity List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Opportunity List.

  3. Enter a description (List name).

  4. Click Add.

Add filters and columns as needed.

Adding and Deleting Tags

You can add Tags to constituent profiles from an Opportunity List (e.g. tagging key contacts on open Opportunities). See Adding or Deleting a Tag from all Constituents on a List.


Pledge List

A Pledge List reports on financial promises that may or may not be tied to an Opportunity. It includes:

  • Individual pledges.

  • Opportunity-related pledges.

You can use it to see:

  • Which pledges have been paid.

  • Which are due.

  • Amounts expected and received.

Creating a Pledge List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Pledge List.

  3. Enter a description (List name).

  4. Click Add.

Add filters and columns as needed.

Example: Active Pledges Due This Month

In Filters, add:

  • Date Paid is Empty.

  • Date Expected is in this month.

Then add columns such as:

  • Constituent Number.

  • Pledge Amount.

  • Notes.

  • Date Expected.

  • Pledge Campaign.

Adding and Deleting Tags

You can add Tags to constituent profiles from a Pledge List (e.g. tagging constituents with outstanding pledges). See Adding or Deleting a Tag from all Constituents on a List.


Timeline Data Lists

Activity List

An Activity is a Timeline entry that records interactions with constituents, such as:

  • Inbound or outbound phone calls.

  • Letters sent or received.

  • Meetings.

  • Requests for fundraising packs.

  • Event registrations, and more.

An Activity List lets you report on these Activities.

You can:

  • Base your List on all Activity Types and then filter for what you need, or

  • Pre-filter the List to a specific Activity Type from a drop-down.

Examples

All Activities with certain types

Use All Activities and filters such as:

  • Activity Type = Eventbrite Order.

  • OR Activity Type = Banger Racing.

Only one Activity Type

  • In the Activity List Details, pre-select Activity Type = Banger Racing.

  • Results include only constituents with that Activity on their Timeline.

Custom Fields in Activity Lists

If your Activity Type has custom fields:

  • When the List is based on All Activities, custom fields appear as Text1, Number1, Yes/No1, etc.

    • The List doesn’t know which Activity Type’s custom fields will be present.

  • When you pre-filter the List to a specific Activity Type:

    • Custom fields appear with the names you assigned in settings.

    • For example: T-Shirt Size, How many people in your team?

Creating an Activity List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Activity List.

  3. Enter a description (List name).

  4. Click Add.

Add filters and columns as needed.

Adding and Deleting Tags

You can add Tags to constituent profiles from an Activity List (e.g. tagging “Attended 2026 Gala”). See Adding or Deleting a Tag from all Constituents on a List.

Mark Timeline Items for Deletion

Sometimes Activity items may be incorrect or no longer required. An Activity List allows you to mark Activities for deletion in bulk.

For a detailed “how-to”, see Bulk Deletion of Timeline Activities.


Gift Aid Declaration List

A Gift Aid Declaration List gives you details of each Gift Aid Declaration (GAD) a supporter has completed, whether:

  • Online.

  • Offline.

You can use it to:

  • Find constituents with Active, Cancelled, or Awaiting Confirmation declarations

  • Identify declarations that are about to expire

  • Add Tags to indicate GAD status on the constituent Timeline

This works well with Auto Tags, which keep such Tags updated automatically as declarations change.

Creating a Gift Aid Declaration List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Gift Aid Declaration List.

  3. Enter a description (List name).

  4. Click Add.

Add filters and columns as needed.

Adding and Deleting Tags

You can add Tags to constituent profiles from a Gift Aid Declaration List (e.g. tagging constituents with an active GAD). See Adding or Deleting a Tag from all Constituents on a List.


Other Data Lists

Change Log List

A Change Log List allows you to see changes made to data in Donorfy, with filters including:

  • Who made the change.

  • When the change was made.

  • What was changed.

  • Which constituent the change relates to.

Typically, the Change Log covers roughly the last 12 months.

Key behaviour:

  • Change Log Lists cannot be downloaded to Excel.

  • You can only produce a PDF report.

Requirements

  • You must be a Donorfy Administrator to use Change Log Lists.

Creating a Change Log List

  1. Click the Add button at the top of Donorfy.

  2. Under Lists, select Change Log List.

  3. Enter a description (List name).

  4. Click Add.

Then:

  • Add a date range filter (strongly recommended) to reduce the volume of data and improve performance.

  • Add other filters (e.g. User, Entity, Field changed) as needed.

Clicking on an item in the List lets you see more detail about what was changed.


Custom List Views (Professional – Own Azure)

Custom List Views let you create your own specialised List views, beyond the standard ones.

Donorfy normally ships with standard views such as Constituent, Activity, Transaction, etc. Custom List Views allow you (or a partner) to define additional views for:

  • Advanced or optimised reporting.

  • Queries that need specially joined or derived data.

  • Performance-sensitive reporting (only returning selected fields, not all default columns).

Requirements

Custom List Views are:

  • Available only on Professional plans.

  • And only if you have an OwnAzure subscription.

If you think Custom List Views are right for your organisation, please contact Donorfy/Access about upgrading.

Steps to Create a Custom List View

To add a custom list view you must:

  1. Create a SQL View to provide the data.

  2. Register the view in Donorfy under Settings.

Because this is a technical task, you may need help from a Donorfy Partner.

Creating Your SQL View

Use SQL Management Studio to create a view that:

  • Is created in schema [custom]

  • Contains the following standard columns (with correct data types and lengths):

    • [FK_TenantId]uniqueidentifier (Guid) – ID representing the Donorfy tenant

    • [EntityId]uniqueidentifier – ID of an existing Donorfy item you can link to

    • [Entity]nvarchar(20) – e.g. Constituent, Campaign, Opportunity

    • [EntitySubType]nvarchar(50) – e.g. Constituent Type, or empty

    • [EntityNumber]bigint – e.g. Constituent Number

    • [Status]nvarchar(10) – typically whether the item is active, based on an IsActive column

    • [Description]nvarchar(100) – description of the row/item

    • [Id]uniqueidentifier – ID of the item returned by the List (often same as [EntityId])

    • [Type]nvarchar(50) – e.g. Opportunity Type, can be empty or same as [Entity] or [EntitySubType]

You also need a column that tells Donorfy which entity to open when a result is clicked (e.g. open a Constituent, Campaign, or Opportunity):

  • Must be of type uniqueidentifier (Guid).

  • Must NOT end in Id..

  • Must NOT contain _FK_.

  • Recommended name: [LinksTo].

Then:

  • Add any other columns you want to make available in the List.

  • Avoid column names ending in Id or containing _FK_ (aside from the required standard columns above).

You can use existing Donorfy standard views (for example, [dbo].[vConstituentBase]) inside your custom view.

You can also examine the standard views used by Lists, named like:

  • v<ListType>Filter, e.g. vConstituentFilter

These can help you understand how to structure your own view.

Allowing Dropdowns in List Filters

If you name columns in your view the same as those in standard Donorfy views, Donorfy can show drop-down options in the filter builder.

For example:

  • If you include a Product column and want it to behave like the standard Transaction Product field, name it Transaction_Product.

Registering the View in Donorfy

Once your SQL View is ready:

  1. Go to Settings, then click Configuration.

  2. Click Custom Lists.

  3. Add a new Custom List entry:

    • Description – appears under Add > Lists.

      • Make sure it does not duplicate a standard List Type name.

    • Custom List Type – tells Donorfy what type of entity to open when a row is clicked (e.g. Constituent, Campaign, Opportunity).

    • View Name – the full view name including schema (e.g. [custom].[vMySpecialConstituents]).

    • Default Sort Column – which column Lists based on this view should sort by (with or without square brackets).

    • Link EntityId Column – the name of the column that contains the ID of the entity to open when a row is clicked (e.g. LinksTo). Do not include square brackets here.

  4. Save the Custom List definition.

Your new Custom List Type will appear under Add, Lists.
You may need to sign out and back in to see it.

Changing the Underlying View

If you later change your SQL View (adding/removing columns, etc.):

  1. Open the Custom List definition in Settings, then click Configuration.

  2. Click Custom Lists.

  3. Click Refresh to update Donorfy with your view changes.

📌Note:

  • Custom List Views are not supported by Donorfy Support directly.

  • They should be supported by the person or Donorfy Partner who built them.


Donorfy Academy

The Donorfy Academy features a learning course for Lists - enrol here.

Did this answer your question?