How Do I Create and Use Custom Fields?

1. Adding Custom Fields to your Program
   1. Create Custom Fields
   2. Assign Custom Fields to Participants
2. Using Custom Fields in Reports
   1. Filtering Reports with Custom Fields

Adding Custom Fields to your Program:

Custom Fields are applied to the Client or Organization, then mapped to Users in your "People" tab. Examples of Custom Fields include: leadership level, location, department, tenure, or other organizational or demographic characteristics.

Once you've set up Custom Fields, and assigned them to Users, you can use these to filter most reports and organize your data for deeper insights using our Adaptable Reports or your own custom reports.

Create Custom Fields for your Client:

1. Navigate to your Client or Organization Dashboard and click on the "Custom Fields" tab. 
2. Click "Add Field"
   
   
3. Name the Field (e.g. Business Unit, Division, Department, Level etc.)
4. Select the Field Type:
   1. Drop down - when adding to a user record, you select from a pre-set list of options or use exact text when doing a bulk upload. You'll need to add the specific options (available values) which will appear in the Field drop down list in the User profile. This type is ideal when you have a limited number of options, and ensures consistency in reports.
   2. Text- this allows you to free-type or upload any data related to the field. This type is more flexible, and useful when you have many options, but may result in duplicates  when reporting.
5. Once you've added your Field Name, Type, and Values, click "Add" to create the Custom Field. You'll see the details above for each field you add. 

Once your Custom Field is created, it will be visible in User profiles, and as a filter for embedded platform reports. You can add, edit or delete Custom Fields anytime.

Assigning Custom Fields to Participants:

You can assign Custom Fields a couple of different ways depending on the size of your program and the timing. 

Option A: Bulk Upload 

1. 1. Path A - Before the Session:
      1. Following the instructions within How to Bulk Upload Participants including the "Custom Field slugs" now available from the previous step. 
      2. Import the User List as a CSV.
   2. Path B - After the Session
      1. On the People tab for the client, Click Export Users.
      2. Use the Exported file to create the User Import List, adding the data to appropriate. columns
      3. Import the User List as a CSV.

1. 1. Once participants have made commitments, navigate to the People tab
   2. Click the Pencil under Options, to see the Participant settings.
   3. Scroll to the bottom of the form, and enter the Custom Field information. 
   4. Click Save, and repeat with next Participant.

Using Custom Fields

Once you've set up Custom Fields and assigned these to Users you'll be able to use them to see dashboard visualizations for the selected field value (i.e for a specific department or region).

Grouping Data by Custom Fields in Dashboard Widgets

Steps:

1. Navigate to the widget you would like to group by a Custom Field
2. Hover over the widget and click the edit button in the upper right corner
   
3. Click "Update/Next"
   
4. Click the edit button in the upper right corner
   
5. Set the Custom Field group by
   1. In the Group By field, choose Custom Field
   2. Choose which Custom Field you want to show
   3. Click Update
   4. Click Done
      

Filtering Dashboards by Custom Fields

Coming soon!