Report ranges
-
- UpdatedFeb 27, 2025
- 5 minutes to read
- Yokohama
- Reporting
Use a report range to define intervals that break up continuous timespan data in table fields. It is necessary to break this data into discreet chunks for presentation.
- Core UI: Bar, pie, and donut reports
- Platform Analytics: All relevant data visualization types including heatmap and time series, when the data source is a table.
Example use case: There is a significant cost involved to a business each time a SLA is breached at a company. A Service Manager can understand which SLAs are being easily met versus which ones are being breached, or are coming close to being breached by viewing how many tasks were completed well within the SLA versus how many elapsed during the SLA.. This information helps them identify which SLAs may need to be adjusted.

How report ranges work
Report ranges work with elements that hold only dates, lists, or integers.
Type | Examples |
---|---|
Dates | Using the Created field in the Incident table: Same Day, 2 Days, 2–5 Days, 5–7 Days, 1–2 Weeks, 2–4 Weeks, 1–2 Months, > 2 Months |
Lists | Using the Priority field in the Incident table: Low, Moderate, High, Critical, Planning |
Integers | Using the Count field in the Incident table: Overloaded, Optimized, Under Utilized |
Report ranges can be globally applied to all date type fields (date, due date, duration, date/time, date time), or you can limit report ranges to a specific table.
View all report ranges
To view all currently configured report ranges, navigate to
. If your instance is migrated to Platform Analytics experience, navigate instead to .
The following are important columns and their associated data types:
Field | Corresponding data type |
---|---|
Upper value duration | Date - works with elements that store dates. |
Upper value int | Integer - works with elements that store numbers. |
Value list | List - works with elements that store a list item. |
Create a report range
Create a report range to define data intervals that are used in bar and pie charts.
Before you begin
Role required: itil, report_user, report_group, report_global, report_admin, or admin.
Procedure
Enable the report range module
To use report ranges in your bar and pie charts, you must enable the report range module.
Before you begin
Procedure
Result