What are score fields?
Score fields are a special type of numerical field that enable special aggregation methods such as top box. They also display in a standalone score widget on the dashboard.
How do I set up score fields on a new project?
Simply select the "Score" field type on the schema mapping page when creating a project. Doing so will open a dialog that allows you to configure how the score field should behave.
![score-field-schema.mp4 [video-to-gif output image]](https://kapiche.intercom-attachments-1.com/i/o/1174884291/5a1386e51bfab873470144b5/ezgif-6-ab163bd2bb.gif?expires=1734783300&signature=0077b185946fe306304d8c07faf4ab5a7409d2b3eccbdac806f32ac9aaf8de65&req=dSEgEsF2mYNWWPMW1HO4zaVYwlTUeRHWUKQ2e5mFYXlalR8IrN7nfNE9E6HV%0AyunE57kLFV4cX%2BN7Jfg%3D%0A)
What do the score field options do?
When selecting or updating a score field you'll be able to configure a few options. Corresponding to the image below:
Set bounds -- setting the lowest and highest numbers in the score range allows us to display the score vales more meaningfully in the score widget as well as accurately calculate top and bottom box aggregations.
Select default aggregation -- this is the default aggregation method that will be used to show the score field value on the score widget and other widgets on the dashboard. Other numerical fields default to average. Top box is generally considered to be a good way to analyse Likert scale data like CSAT and other ratings.
Change top/bottom box limit -- when top or bottom box aggregation is selected we default to top/bottom 2 box, but you can easily change this to suit your data and reporting requirements.
Where are score fields displayed on the dashboard?
Score Range Widget
The score widget displays the overall value for the field as well as the value over time. You can read more about the score range widget here.
Themes Widget
You can select score fields with their configured aggregation method from the new SCORE section in the DISPLAY menu.
Timeline
You can select score fields with their configured aggregation method from the new SCORE section in the DISPLAY menu as well as impact from the IMPACT ON section.
Quadrant Chart
You can select score fields with their configured aggregation method from the new SCORE FIELD section in the DISPLAY menu.
Pivot Table
When you select a score field for the display value, you'll be able to choose top or bottom box as the aggregation method alongside the existing aggregation methods.
Email Digest
Anywhere you can choose a display metric on the email digest you will be able to choose score fields which will be displayed according to their configured aggregation method.
How do I update score fields ?
If you want to change how a score field is configured:
Visit the project settings page
Expand the project schema
Find the score field and click the "Edit" button
Make desired changes and hit the "Done" button
Don't forget to hit "Update" on the project settings page to lock in the changes
![[video-to-gif output image]](https://kapiche.intercom-attachments-1.com/i/o/1174884316/1db5c151547d929bcac20061/ezgif-6-4aeebf891e.gif?expires=1734783300&signature=63edc555acfe20a0f7668180ff39b9ca1637271018b975fd1776f4c9b8099f6c&req=dSEgEsF2mYJeX%2FMW1HO4zfxGI0NjltMYwxoZe9ZFgjiorEYX3sNk1b4BPffR%0ALXdfvMrq1dKac2pUWRA%3D%0A)
How do I set up score fields on an existing project?
If you would like to set up a score field on an existing project please reach out to us and we'll sort it out for you!