How Do I Create and Use Custom Fields?

Article Quick Links:

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 - Use this when you're adding data for 10 or more participants

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.

Option B: Manually Assign -  Use when updating less than 10 Participants

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

Coming Soon!  When you have Custom Fields enabled. 

Steps:

1. Navigate to your Report screen (either via Reports link in sidebar, or Reports tab in your program).
2. Select your filters (if required)
3. Select the widget you'd 
4. Click the drop down menu to select which field options to include in the report.
5. Under "Values for Custom Field #1" click the drop down and select which value(s) to include in the report. (You can select more than one value. It will aggregate the data vs. show a comparison)
6. You can cross filter by following the same steps and selecting a second field and values under "Field # 2" option, or leave this blank.
7. Click "Generate Report"

Filtering Dashboards by Custom Fields

Coming soon!