Custom fields
Configure custom fields to capture additional information specific to your organization's opportunities. Custom fields extend the opportunity form beyond the standard fields and three built-in optional text fields.
Audience: Administrators who configure opportunity data capture for the organization.
On this page
Before you begin
You need the following permissions:
Permission: Add or Edit (under CustomFields in the Administrator section) — Required to create and modify opportunity custom fields.
Your organization must have the Sales > Opportunities license active.
The custom fields feature must be enabled for your organization.
Steps
Follow these steps to configure custom fields for opportunities.
Access custom fields configuration
- Navigate to Configuration > Opportunities > Opportunity custom fields.
Note: The page opens with the header Opportunity custom fields and the buttons Add Field, Manage Groups, Search, Edit, Preview, and Save. The grid lists each field's Active, Group Name, Field Name, Field Code, Description, Type, Display Order, and Show In Row values.
Create a new custom field
Worked example: A wellness center wants to capture how a guest heard about a promotional membership offer. The administrator creates a Dropdown field named "Promotional channel" with options such as "Social media", "Email", and "In-center signage". Staff select the appropriate option when creating or editing an opportunity, and the value is saved with that opportunity record.
Click Add Field. The Add New Field dialog opens.
Configure the following settings:
- Field Name — Enter a descriptive name for the custom field.
- Field Code — Enter a code that identifies the field.
- Description — Enter additional information about the field.
- Field Type — Select from Checkbox, Date, Dropdown, Label, Number, Radio Button, Signature, Textbox, Textbox - Large, or Yes/No.
- Display Order — Enter the position of the field relative to other fields.
- Group Name and Group Display Order — Optionally assign the field to a group and set the group's position.
- Show this field on its own in a single row — Select to place the field alone on its row of the form.
For numeric inputs, optionally set minimum and maximum validation values to enforce a numeric range.
For list-type fields (for example, Dropdown or Radio Button), add the options that users can choose from.
Click Add Field, or Add & Continue to save and start another field.
Modify an existing custom field
- Locate the custom field in the list and select it.
- Click Edit.
- Update the field properties as needed.
- Click Save.
Important: Changing a field type may affect how existing values are displayed on opportunity records. Review all opportunities using this field before making structural changes.
Tips
- Use descriptive field names that clearly indicate what information should be entered.
- Consider using Dropdown fields instead of Textbox fields when you want to standardize responses and enable better reporting.
- The opportunity form also includes three built-in optional text fields (Optional Text 1, Optional Text 2, Optional Text 3) in addition to custom fields. These built-in fields are always available and do not require configuration.
- Custom field values are saved per opportunity and appear on the opportunity creation and edit forms.
- Group related custom fields together using the custom field grouping feature. See Custom field grouping and colors.
Troubleshooting
- Custom fields do not appear on the opportunity form. Verify that the custom fields feature is enabled for your organization. If the feature is not enabled, contact your administrator to confirm the required license is active.
- A field type change causes existing values to display incorrectly. Field type changes affect how previously saved values are rendered. If values appear blank or malformed after a type change, revert the field type to its original setting and migrate existing data before changing the type again.
- Numeric range validation is not enforced. Numeric range validation applies only when a value is entered in a numeric input. If the field type is Textbox or Textbox - Large, range validation is not available. Switch to a field type that supports numeric input to use this feature.