Skip to main content

​
Zoom Level Summary

CodeLabelTimescale HeaderDescription
HHoursDay over hoursFinest zoom level showing individual hours
DD2-DayWeek over 2-day groupsIntermediate day-level detail
DDayWeek over daysIndividual day columns
WWeekMonth over weeksDefault zoom level
MMonthYear over monthsMonthly planning view
QQuarterYear over quartersQuarterly roadmap view
YYearMulti-year over yearsAnnual planning view
YY2-YearMulti-year over 2-year groupsCoarsest zoom for long-range roadmaps
The default scale is W (Week). Users see a weekly timeline when first loading the Gantt chart without a saved preference.

​
Zoom Level Details

​
Hour-Level Zoom (H)

PropertyValue
CodeH
Upper header rowDay
Lower header rowHour
Use caseHour-precision scheduling with high-precision mode enabled
Hour-level zoom requires Duration Precision set to High (Hours) for accurate hour-level task display. See Data Mapping Parameters.

​
Day-Level Zoom (D and DD)

PropertyDDD
CodeDDD
Upper header rowWeekWeek
Lower header rowDay2-Day
Use caseDaily task trackingDay-level overview

​
Week-Level Zoom (W)

PropertyValue
CodeW
Upper header rowMonth
Lower header rowWeek
Use caseSprint and release planning views

​
Month, Quarter, and Year Zoom (M, Q, Y, YY)

PropertyMQYYY
CodeMQYYY
Upper header rowYearYearMulti-yearMulti-year
Lower header rowMonthQuarterYear2-Year
Use caseRelease planningQuarterly roadmapAnnual roadmapExecutive overview

​
Timescale Header Structure

Each zoom level renders a two-row timescale header at the top of the Gantt chart: diagram

​
Accessing Zoom Controls

You can change the zoom level using any of the following methods:
MethodLocationDescription
Toolbar zoom buttonsGantt toolbarZoom in (+) and zoom out (-) buttons
Set scale submenuHamburger menuRadio-button list of all available scales (Hour, Day, Week, Month, Quarter, Year)
Timeline right-clickTime scale headerContext menu with scale selection and Go to today
Keyboard shortcutGantt chartSee Toolbar Actions and Keyboard Shortcuts

​
Zoom Level Persistence

The current zoom level is automatically saved to browser local storage and restored on the next page load. This persistence is scoped per document URL and widget instance.
BehaviorDescription
Save triggerZoom level is saved each time you change the scale
Restore triggerZoom is restored from local storage during Gantt initialization
ResetUse the Reset view action to clear saved zoom and column preferences
ScopePer-user, per-document URL, per-widget instance

​
Zoom and Resource View Interaction

When the resource view is enabled, zoom level changes affect resource marker aggregation:
  • Zooming out aggregates daily/weekly resource allocation values into larger time buckets
  • Red overallocation flags may appear or disappear depending on how time cells aggregate at different zoom levels
  • Resource load thresholds are evaluated per-cell, so wider cells at lower zoom levels accumulate more work items
At coarse zoom levels (Month, Quarter, Year), resource allocation cells cover longer time periods. Overallocation flags may trigger more frequently because each cell aggregates more work items. Set your threshold based on your typical zoom level.

​
Custom Timescale Configuration

You can customize zoom level scales using the Gantt Config Script to render week numbers or other custom date formats: 
// Example: Show calendar week numbers (CW format) in the Week zoom level
gantt.config.zoomConfig.levels[3].scales[1].format = function(date) {
    var weekNum = gantt.date.getISOWeek(date);
    return "CW" + weekNum;
};
See Gantt Config Script API for the full scripting reference.

​
Configuration Example

Set the default zoom level using the Gantt Config Script widget parameter: 
// Set default zoom to Month view
gantt.ext.zoom.setLevel("M");
Support TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/config.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/default.json
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/zoom.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/view/checkToolbarScale.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/components/Menu.js