Configure and use custom fields

Custom fields are used to capture information about a profile that can't be captured through PassFort's standard fields.

You can add this information directly to the profile or it can be captured via answers on forms.

When information is captured, you can view it in Profile data > Custom Fields. Depending on the configuration options for the custom fields, you may also see it Profile data > Information as well.

Configuring custom fields

Let us know which custom fields you'd like to add and we'll set them up for you.

To see the custom fields we've configured for your account, log into the PassFort Portal and go to Policy Builder > Custom fields.

Custom field settings

Every custom field has these settings:

• Individual and/or Company (required): Whether the custom field can be used for profiles for individuals and/or profiles for companies.
• Field name (required): The name of the field that Portal users see.
• Developer name (required): Sometimes known as an alias, this is the name that developers see when calling PassFort's API. If you're not sure which developer name you'd like to use, we can choose one for you.
• Description (optional): The description of the field that Portal users see.
• Content type (required): The type of content for the field. A full description of all the content types is below.
• Show custom field / Hide custom field (required): When Show custom field is selected, the field is visible to Portal users when they go to Profile data > Custom fields. When Hide custom field is selected, the only way to see the field is through the API and (if configured) a form.
  • Display under Profile Data > Information (optional): When this option is selected, the field is visible under Profile data > Information as well as Profile data > Custom fields.

Content types

Each custom field has one of the following content types:

• Multi select: Multiple options can be selected. You provide the list of options during configuration.
• Single select: One option can be selected. You provide the list of options during configuration. Optionally, you can also enable users to type an answer, which is useful if their answer doesn't match any of the options provided.
• Text: A free text field.
• Country: One country can be selected. Countries available for selection are the ones that have ISO3 codes.
• Multi country select: Multiple countries can be selected. Countries available for selection are the ones that have ISO3 codes.
• URL: A free text field. When this custom field is viewed in Profile data, it's presented as a hyperlink. Note that the URL format is not validated.
• Number: A whole number. Negative numbers are accepted.
• Currency: An amount in a given currency. You provide the currency during configuration. Whole numbers are used for the amount, including negative numbers.
• True/False: Two radio buttons. One says Yes and the other says No.
• Date: A date provided in the format YYYY-MM-DD.

Deactivating custom fields

If you're no longer using a custom field, we can deactivate it for you. This prevents the field from being added to more profiles.

Any profiles that already have data for this field will continue to display the information in Profile data, but the data will no longer be editable.

Deactivated custom fields are displayed at the bottom of the custom fields list when you go to Policy Builder > Custom fields.

Add or edit custom field data via the Portal

To add/edit the data for a custom field:

1. Go to the profile you'd like to add the information to.
2. Click Profile data.

   

3. Click the Edit icon and select Edit custom fields. The Edit custom fields dialog is displayed, showing every custom field that can be used for the profile type.

   

4. Add or edit the information as required.
5. Click Save. All custom fields with data are displayed under Profile data > Custom Fields.

Add or edit custom field data via the API

Custom fields are stored in the collected_data.custom_fields_data object.

Get the step-by-step instructions for updating a profile's collected_data or check out the Update collected data resource in the API reference.

See custom field data collected via forms

Forms can be configured so when a customer answers a question, the data is added to or updated for a custom field.

If the custom field is set up so that it's visible in the Portal, the data is displayed in Profile data > Custom Fields.

Otherwise, the only way to see the custom field is for a developer to get the profile's collected_data via the API.