What Are Duration Fields?
Duration fields are a special type of numerical field that allow represent values of a length of time. They are displayed on a standalone score widget on the dashboard and a range of other dashboard widgets. They are stored internally as ISO 8601 durations (PT1H30M, P1DT2H, PT45S). Displayed in the UI in human-readable form (1h 30m, 2 days 3h, 45s).
When to Use Duration Fields
Tracking contact centre metrics: handle time, resolution time, wait time
Monitoring SLA performance: time to first response, time to close
Product analytics: session length, time on task, watch time
Any feedback dataset where "how long" matters
How do I set up duration fields on a new project?
Simply select the "Duration" field type on the schema mapping page when creating a project. We will detect what type of values are in the field e.g. seconds, minutes etc.
You can also edit the duration in the project settings page, under the Project Schema. Here you can change from auto detect to a specific setting e.g Human Readable 1h 30minutes.
Where are durations 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.