Skip to main content

​
What Gets Saved

The Gantt chart persists the following user-level settings:
SettingWhat It ControlsWhen It Saves
Zoom scaleThe active timescale level (e.g., Week, Month, Day)When you change the zoom level via the toolbar or menu
Column widthsThe pixel width of each grid columnWhen you resize a column by dragging its border
Grid widthThe overall width of the left grid panel (split point between grid and chart)When you drag the grid/chart divider
Column visibilityWhich columns are shown or hiddenWhen you toggle columns via the column header context menu
These settings are distinct from the configuration parameters set by administrators. Configuration parameters define the defaults and available features; user settings represent each user’s personal customization on top of those defaults.

​
How Storage Works

User settings are stored in the browser’s localStorage, keyed by a combination of:
  • The document URL (the Polarion page containing the Gantt chart)
  • The setting name (e.g., SCALE, GRID)
  • A version identifier that prevents stale settings from older Gantt versions from persisting
This key structure means that your zoom preference on one Gantt page is independent of your zoom preference on another. Each Gantt chart on each page maintains its own set of user preferences. diagram

​
The Settings Lifecycle

When a Gantt page loads, the initialization process follows this sequence:
  1. Configuration parameters are resolved from the server (admin defaults + per-instance values).
  2. User settings are loaded from localStorage.
  3. User settings override the configuration defaults where applicable. For example, if the default scale is W (Week) but the user previously set it to M (Month), the chart loads in Month view.
  4. The Gantt renders with the combined configuration.
When the user changes a setting (e.g., switches zoom to Quarter view), the new value is immediately saved to localStorage. On the next page load, the Quarter view is restored.

​
Resetting to Defaults

If you want to clear your personal preferences and return to the configured defaults, use the Reset view action in the toolbar. This clears all user settings from localStorage for the current Gantt chart, reverting zoom, column widths, column visibility, and grid width to their original state.
If your Gantt chart loads with an unexpected zoom level or column layout, it may be because a previously saved user preference is overriding the configured defaults. Use the Reset view toolbar action to clear saved preferences and start fresh.

​
Browser and Session Scope

Because user settings are stored in localStorage (not on the server), they have the following characteristics:
  • Per-browser: Settings are specific to the browser you are using. If you switch from Chrome to Firefox, your preferences do not follow.
  • Per-device: Settings do not sync between your desktop and laptop.
  • Persistent: Settings survive browser restarts and page reloads. They are not cleared when you log out of Polarion.
  • Clearable: Clearing your browser’s site data or localStorage will remove saved Gantt preferences.
The Gantt includes a version identifier in its storage keys. When a new version of the Gantt introduces changes to the settings format, the version is incremented, and any stale settings from the previous version are effectively ignored. This prevents compatibility issues after an upgrade.

​
Column Visibility Persistence

The column context menu (accessible by right-clicking any column header) allows you to show or hide individual columns. These visibility choices are persisted in localStorage alongside other user settings. The first column (typically the task title) is always visible and cannot be hidden. After hiding columns and reloading the page, your hidden columns remain hidden. This persistence applies to both built-in columns and custom columns defined in the configuration.

​
Interaction with Configuration Parameters

User settings sit on top of the configuration hierarchy described in Configuration Layers and Precedence. The precedence order is:
  1. User settings (localStorage) — highest priority for supported settings
  2. Per-instance parameters — per-chart configuration
  3. Administration properties — system/project defaults
  4. Built-in defaults — hardcoded fallbacks
This means a user can always override the zoom level or column layout set by the administrator, but they cannot change features that are not exposed as user settings (such as enabling auto-scheduling or switching the resource load mode).
Support TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/view/checkToolbarScale.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/userSettings.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/commands.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/lightbox/assigneeCustomField.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/columns/column-context-menu.cy.ts