How Do I Use Custom Fields?

The Custom Fields and Custom Collections feature in Virtuous Raise allows your organization to collect and store data that's unique to your organization. Custom Fields are user-created fields to track specific data or capture mission-critical details on your page Custom Collections are a series of related values or fields with an undefined amount of entries. Use this article to learn how to add Custom Fields or Collections to your page. 

Table of Contents

1. Create Custom Fields
2. Adding Custom Fields to Forms
3. Making Custom Fields Conditional
4. Syncing with Virtuous CRM+
5. Custom Collections
6. FAQ

Create Custom Fields

Create Custom Fields directly within Virtuous Raise by navigating to Settings and then Custom Fields. At the top of the page toggle on the Create custom fields in Virtuous Raise setting. Then click + New Custom Field in the top right corner to create a new field. 

Name your Custom Field and select Gift or Donor as the Entity Type. Choose a data type which includes the following options: text, paragraph, list, multi-select, boolean, date, number, and link. Each field type offers display customizations such as dropdowns, buttons, and radio selections.

Adding Custom Fields to Forms

Custom Fields (or Custom Collections, see below) can be added to donation forms using the Add Component section in the builder, making it easy to customize forms based on specific needs. 

Drag and drop the Custom Field input component into your form. Then, use the right-hand menu to select the Custom Field and configure:

• Custom Field Label
• Make Field Required
• Make Field Hidden
• Make Field Conditional (learn more below)

Making Custom Fields Conditional

The Make the field conditional setting controls when the Custom Field displays on your form. For example, you want only gifts over $100 to display a custom field asking donors for feedback; you can create this condition for the minimum gift amount.

To add a condition, turn on the toggle in the Custom Field Component. Then select the + Add Condition button.

A dropdown list of Conditional Sources displays including: Project Selection, Custom Field Response, (Recurring Gift) Frequency, and (Gift) Amount.

The Operators and Condition Values available for you to use depends on the Conditional Source. For example, if you choose Custom Field Response as your Source, you will be prompted to select the Custom Field, and then the corresponding response value.

Once entered, select to save your condition. You can choose to add additional conditions that must be met for the same Custom Field (e.g. Amount is Greater Than or Equal to 100 and Frequency is One-Time) or delete your conditions by selecting the trash icon.

Syncing with Virtuous CRM+

Custom Fields in Virtuous Raise can sync bidirectionally with Virtuous CRM+, ensuring data consistency. Fields created in Virtuous Raise appear in Virtuous CRM+, and vice versa, allowing changes made in one app to reflect accurately in the other. You can also choose not to sync specific fields if you wish to keep them within Virtuous Raise only. 

When creating or editing a Custom Field, toggle on the Sync custom field data to Virtuous CRM+ switch if you wish to sync this field back into Virtuous CRM+. If toggled off, this field and its data only appears in Virtuous Raise and does not sync to Virtuous CRM+. Additionally, if you haven’t turned on the integration with Virtuous CRM+ yet, do that before attempting to sync Custom Fields with Virtuous CRM+.

Custom Collections

Beyond individual fields, you can also sync Custom Collections from Virtuous CRM+ to be used in Virtuous Raise Forms and Pages. Custom Collections group related fields together for capturing more complex data sets. These collections of fields can support one response for each set of fields, offering flexibility in data input and management. Custom Collections can be toggled to show specific fields and accept multiple entries on forms, enhancing the level of engagement with donors.

In order to use these Custom Collections from your Virtuous CRM+ app inside a Virtuous Raise Form, a few things need to be done first:

1. Your Virtuous CRM+ and Virtuous Raise platforms must be integrated.
2. Custom Collections need to be created inside Virtuous CRM+, which will then sync over to Virtuous Raise through the integration.
3. Once those two steps have been completed, add the Custom Collection component to a Virtuous Raise Form or Page to be answered by donors when they make a donation.

FAQ

• Reporting and Query builders in Virtuous CRM+ will include Custom Field and Collection data from Virtuous Raise.
• When the Virtuous CRM+ integration is enabled, Custom Field and Collection data will be sent to the Virtuous CRM+ Gift and Contact Import Tool.
• Yes, it is possible to set the default value for a hidden Custom Field in the page builder.
• URL parameters can set a value for a Custom Field if it is not hidden.