Skip to main content
Gantt is a Gantt chart extension for Siemens Polarion ALM that provides interactive project scheduling, resource management, dependency tracking, and visual timeline planning. It embeds directly into Polarion LiveDoc and Wiki pages as a configurable widget, enabling teams to plan and track work items on a visual timeline without leaving the ALM environment.
Gantt delivers standard Polarion widgets, so every Polarion user can access the Gantt widgets. Any Polarion user with the license and permission to edit work items (or Plans) can edit tasks using the Gantt widget. Any Polarion user who can create a LiveDoc report page can configure and set up the Gantt widgets. See Licensing and User Access for setup details.
Yes, the evaluation period is limited to 30 days from the date of installation. If you need more time, contact Nextedy to request an extended time-limited license. Upon expiration, the software automatically disables itself, and you must obtain a license certificate for continued use.
Reach out to Nextedy support before your 30-day evaluation expires to request an extension.
No, currently only one Gantt widget is supported per report page. If you need to display multiple views, create separate Polarion pages for each Gantt widget instance.
Work Items Gantt displays individual Polarion work items as task bars on the Gantt chart, allowing you to schedule, link, and track individual tasks. Plans Gantt displays Polarion Plans as containers, enabling cross-team and release planning views. See Set Up a Basic Gantt Chart and Set Up a Plans Gantt Chart for setup instructions.
The table below summarizes the main feature areas available in Gantt:
Feature AreaDescription
SchedulingAuto-scheduling, dependency links, critical path analysis
ResourcesResource view, capacity planning, load modes, working calendars
VisualizationBaselines, configurable columns, timescales, export to PNG
EditingLightbox inline editor, drag-and-resize task bars, undo/redo
ScriptingItem scripts and page scripts for custom colors, markers, behavior
PlansPlans Gantt mode for plan-level scheduling and cross-team views
For detailed guidance on each area, browse the Guides and Concepts sections.
Start by installing the extension following the Install Gantt tutorial, then explore the demo project to see a working Gantt chart with pre-configured tasks, dependency links, and resources. The Getting Started section walks you through setup step by step.
The Reference section contains complete documentation of all widget parameters, administration properties, and configuration options. For task-oriented walkthroughs, visit the Guides section.
Auto-scheduling automatically updates the start date of dependent tasks based on the end dates of their predecessors. When you move a task or modify a dependency link, all connected successor tasks are rescheduled to satisfy the dependency constraints. You can toggle auto-scheduling on and off using the toolbar button. To set the default state, configure the nextedy.gantt.default.auto_scheduling project-level property. See Create Your First Dependency Link for a practical walkthrough.
Yes, you can use a combination of techniques to control scheduling at different levels. Set top-level items to readonly mode to prevent auto-scheduling from moving them, while allowing child tasks to reschedule automatically. You can also use the enforceAutoMode and blockAutoMode task-level flags to override the global auto-scheduling setting on individual tasks.
For waterfall projects, pin milestone and top-level items using blockAutoMode, then let auto-scheduling handle lower-level task dependencies.
Gantt uses a last-save-wins approach for concurrent editing. There is no built-in real-time conflict detection between simultaneous users. When two users edit the same task, the most recently saved version takes effect. Plan your editing workflows to minimize overlapping changes on the same work items.
Coordinate with your team to avoid editing the same tasks simultaneously. The last save always overwrites previous changes.
Critical path analysis highlights the longest chain of dependent tasks in your project. Tasks on the critical path are visually marked in the Gantt chart so you can identify which tasks directly affect the project end date. Toggle critical path highlighting using the toolbar button. Critical path requires dependency links to be defined between tasks.
Hour-precision scheduling switches the Gantt from day-level to hour-and-minute-level task planning. When enabled via the highPrecision configuration, task start and end times include specific hours, enabling sub-day scheduling. This mode is required for accurate resource load calculations at hourly granularity. Note that date display in columns automatically adjusts when high-precision mode is active.The following table summarizes the key scheduling features and their configuration:
FeatureConfigurationDescription
Auto-schedulingnextedy.gantt.default.auto_schedulingDependency-driven date recalculation
Critical pathToolbar toggleHighlights longest dependency chain
Hour precisionhighPrecision widget parameterSub-day scheduling with hours/minutes
Dependency linksdependsRoles widget parameterFinish-to-start task relationships
Block auto-scheduleblockAutoMode per taskPins individual tasks against auto changes
Enforce auto-scheduleenforceAutoMode per taskForces auto-scheduling on individual tasks
The Gantt chart does not support manual drag-and-drop task reordering. Instead, use the sort-by-field functionality to order tasks by any configured column such as start date, priority, or work item ID. Configure the sort behavior through the widget parameters.
Task sorting is controlled through widget parameter configuration. Check the reference documentation for available sort options.
Enable the resource view by setting the showResourceView widget parameter to true. This displays a resource allocation panel below the Gantt chart, showing per-resource workload markers across the project timeline. See View Resource Allocation for a step-by-step setup guide.
The Gantt resource view supports four load calculation modes controlled by the resourceLoadMode configuration property:
ModeValueDescription
Task countnumShows the number of tasks assigned per resource per day
Allocated hourstimeShows total allocated working hours per resource per day
Remaining hoursremainingShows remaining available capacity (total minus allocated)
Allocation percentageallocationShows utilization as a percentage, color-coded by load level
Use allocation mode to quickly identify overloaded resources. Cells turn red when a resource is allocated beyond their available capacity.
Resource allocation markers use configurable color thresholds defined by the resourceMarkersColorConfig property. This configuration includes an ok color for within-capacity states and an over color for overallocated states. When using allocation mode, cells are color-coded based on whether the resource’s utilization exceeds their available working hours.
Yes, use the resource hiding toggle in the toolbar to hide resources with no visible tasks in the current view. This reduces visual clutter when working with large resource pools. The toggle dynamically re-evaluates which resources have active tasks and shows or hides them accordingly.
The Gantt chart uses working calendars to determine available working hours per resource per day. Each resource can have a per-user working calendar assigned via a calendar work item type in Polarion. The calendar defines regular weekly hours per weekday in HH:mm,HH:mm format, with - marking non-working days. Calendars support inheritance, so a child calendar inherits base hours from a parent and can override specific days.
Working hours for a specific date are resolved in this order: base calendar, then regular weekday hours, then schedule tweaks, then exceptions (time off / time on).
Yes, working calendars support three types of exceptions linked via the affects link role:
  • Time off — marks specific dates as non-working (holidays, PTO)
  • Time on — marks specific dates as working days (overriding regular non-working days)
  • Schedule tweak — adjusts working hours for a date range without changing the working/non-working status, using workstart and workend fields
Exception work items must be linked to the calendar via the affects link role for the system to recognize them.
Configure the nextedy.gantt.calendarHolder server property with a Polarion user ID. The system uses the calendar work item assigned to that user as the global working calendar. This is useful for establishing organization-wide working hours without assigning calendars to each individual user.
Ensure the calendar work item has a valid From and To date range that covers your project’s scheduling period.
Yes, the Gantt supports team-based assignment mode via the teamAssignments configuration property. When enabled, the lightbox shows a team picker instead of a user picker for resource assignment. Related properties include teamCustomField, teamAssignmentStartField, teamAssignmentEndField, and teamAssignmentCapacityField for defining the team assignment data model.
The Gantt evaluation period is limited to 30 days from the date of installation. If you need additional time for evaluation, contact Nextedy support to request an extended time-limited license. Upon expiration, the software automatically disables itself until you obtain a valid license certificate.
The Gantt widget will stop functioning after the 30-day evaluation period. Plan your evaluation timeline accordingly and reach out for an extension before it expires.
Yes, trial licenses can be extended beyond the initial 30-day period. Contact Nextedy support to request a continuation of your evaluation. This is useful when your team needs more time to complete the evaluation process or when procurement timelines are longer than expected.
Gantt uses a subscription-based licensing model for new licenses. Perpetual licenses are available only as upgrades for existing customers. Edit access is controlled by the nextedy_gantt_users group — members are Editors, everyone else has read-only Reviewer access (see Licensing and User Access).For the technical license-file types (Primary/Secondary Evaluation, Perpetual, Test) and their expiry behavior, see License Types and Evaluation Periods.
Yes, licenses can be used on both nodes of a multi-node Polarion deployment. There is no restriction on deploying your Gantt license across clustered or high-availability Polarion server configurations.
When the Gantt license is invalid or expired, a license status panel appears at the top of the Gantt widget with an appropriate message and contact information. The panel displays one of three states: valid (ok), approaching expiry (warning), or expired (expired). The license status is checked once at startup when the widget loads.
An expired license prevents the Gantt widget from functioning entirely, displaying a license panel with contact information. Expired maintenance means your license is still active, but you are no longer entitled to software updates or new feature releases. You can continue using the currently installed version, but you cannot upgrade to newer versions until maintenance is renewed.
You can access the Gantt administration settings by clicking the gear icon in the Gantt widget footer. This opens the administration page where you can view and manage license configuration. The Gantt version number is also displayed in the widget footer for reference.For complete licensing setup instructions, see Licensing and User Access.
This page covers the scripting API at a high level. Verify specific script syntax and available variables in the Gantt application and Reference documentation.
Gantt supports two types of scripts: item scripts and page scripts. Item scripts run against individual tasks and can modify their appearance, such as changing task bar colors or adding markers. Page scripts run once when the Gantt chart loads and can modify global behavior, configuration, and register custom editors or markers.
Item scripts allow you to customize individual task bars based on work item properties. Common use cases include applying conditional color coding based on status or priority, adding visual markers to specific tasks, and modifying task labels. Item scripts execute on the server side with access to the task data and Polarion work item fields.
Page scripts run at page load time and provide access to the Gantt configuration, editor registry, and marker utilities. You can use page scripts to register custom column editors, add timeline markers (such as milestone dates or sprint boundaries), and modify configuration values before the Gantt chart initializes.
Script TypeRunsScopeCommon Use Cases
Item scriptPer taskIndividual task barColor coding, markers, label customization
Page scriptOnce at loadEntire Gantt chartCustom editors, timeline markers, config overrides
Page scripts can add custom vertical line markers to the Gantt timeline using the marker utilities exposed through the scripting API. Markers are commonly used to indicate today’s date, milestone deadlines, sprint boundaries, or plan due dates. The “Today” marker is built in and displayed by default.
Check the scripting reference for the exact API to add custom markers, including available styling options.
Yes, item scripts are the primary mechanism for applying conditional task bar colors. You can write logic that reads work item fields (such as status, priority, or a custom field) and returns a CSS color value to apply to the task bar. This lets you visually distinguish different categories of work items on the Gantt chart.
Yes, page scripts can register custom inline column editors through the editor registry. These custom editors appear in the Gantt grid columns and allow users to edit task fields using specialized input controls beyond the default text and date editors.
Custom editor registration must occur before the Gantt chart initializes. Refer to the scripting reference for the editor registration API.
For more on Gantt capabilities, see the Concepts and Guides sections.
This page provides an overview of configuration concepts. Refer to the Reference section for complete property documentation.
Gantt uses two levels of configuration. Widget parameters are set per-widget instance on the Polarion page and control the behavior of that specific Gantt chart. Administration properties are set globally in the Polarion administration panel and apply to all Gantt widgets across the project or server. Widget parameters take precedence over administration properties when both define the same setting.
Configuration LevelScopeSet WhereExample
Widget parameterPer widget instancePolarion page widget editorshowResourceView, readonly
Administration propertyProject or server-widePolarion Administration panelnextedy.gantt.default.auto_scheduling
Field mappings tell the Gantt which Polarion work item fields to use for task start dates, end dates, duration, and progress. You need at least two of the three date fields configured: startField + endField, startField + durationField, or endField + durationField. The Gantt validates these mappings at render time and displays an error message if the combination is invalid.
You must configure at least two of startField, endField, and durationField. The Gantt widget will not render without a valid field mapping combination.
The work items shown in the Gantt are selected by the Work Items dataset parameter (query, collection, or scope) — there is no dedicated work item type parameter. Restrict the displayed type by writing the query accordingly, for example type:workpackage. See Work Items Gantt Widget Parameters for the dataset parameter. To control how each work item type renders (as a task bar, summary, or milestone), set the Gantt Presentation Mode per type in the Work Item Types Configuration.
The exact work item type IDs available depend on your Polarion project configuration. Check your project’s work item type definitions.
Yes, enable the Read-only parameter (readonly) to disable all editing capabilities. This hides the Edit button and prevents drag, resize, and add-task operations. Conversely, enable always-edit mode (alwaysedit) if you want the Gantt to always be in edit mode without requiring users to click an Edit button first.
The Resource Field parameter (resourceField) specifies which Polarion work item field is used as the assigned resource. This drives both the resource view display and the resource filter functionality. The field can be set to the assignee field, a category field, or a custom field depending on your resource management model.For full setup instructions, see Set Up a Basic Gantt Chart and the Reference documentation.
This page covers editing workflows at a high level. Consult the Guides section for detailed how-to instructions.
Click the Edit button in the Gantt toolbar to enter edit mode. Once in edit mode, you can drag task bars to change dates, resize them to adjust duration, and create dependency links between tasks. All changes are tracked as pending until you explicitly save. If alwaysedit is enabled via widget parameters, the Gantt is always in edit mode and no Edit button is shown.
Click the Save button in the toolbar to persist all pending changes to Polarion. The save operation sends all modified tasks and dependency links to the server in a single transaction. A progress indicator appears during the save process. If there are no unsaved changes, the save button has no effect.
ActionHowNotes
Enter edit modeClick Edit in toolbarNot needed if alwaysedit is true
Move a taskDrag the task bar horizontallyChanges start and end dates
Resize a taskDrag the right edge of the task barChanges duration or end date
Save changesClick Save in toolbarPersists all pending edits to Polarion
Undo changesUse undo in the toolbarMulti-step undo of date changes and moves
The lightbox is an inline editing dialog that opens when you double-click a task bar or click the edit icon on a task. It provides form fields for editing task properties such as dates, duration, progress, assigned resources, and custom fields. Changes made in the lightbox are applied to the task when you confirm and are included in the next save operation.
Yes, Gantt supports multi-step undo and redo for task date changes, moves, and resizes. Use the undo/redo controls to step back through your editing history before saving. Once you save, changes are committed to Polarion and can no longer be undone through the Gantt undo feature.
Always review your changes before clicking Save. Undo is only available for unsaved edits made in the current editing session.
Gantt uses a last-save-wins approach. There is no real-time conflict detection between concurrent editors. If two users modify the same task, the version saved last overwrites previous changes. Coordinate with your team to avoid editing the same work items at the same time.
Plan your editing workflows to minimize overlap. The most recently saved version always takes effect.
Yes, set the readonly widget parameter to true to make the entire Gantt chart read-only. For more granular control, individual tasks can be set to read-only mode, which prevents drag, resize, and edit operations on those specific tasks while keeping the rest of the chart editable.
Per-task read-only control may be configured through item scripts or task properties. Check the reference documentation for available options.
Yes, when the maximize widget parameter is set to true, a fullscreen toggle button appears in the toolbar. Clicking it expands the Gantt chart to fill the browser window, providing more screen space for viewing and editing large project schedules.For editing setup details, see Set Up a Basic Gantt Chart.
This page covers visualization features at a high level. Refer to the Reference section for detailed property documentation.
Gantt supports baselines for comparing your current schedule against a saved snapshot. The Compare with History feature allows you to select a historical date, a named baseline, or a specific revision number. When active, baseline bars appear below the actual task bars, showing the originally planned start and end dates alongside the current dates.
Yes, Gantt provides an export-to-PNG feature accessible from the toolbar. The export panel renders the Gantt chart as an image and provides download and print buttons. You can apply date filtering to control which portion of the schedule is included in the export.
The Gantt widget cannot be exported to PDF format. Use the PNG export feature for sharing static schedule snapshots.
Task bar colors can be set in two ways. Each work item type has a default color that is automatically applied to its task bars. For more dynamic control, use item scripts to apply conditional color logic based on work item fields such as status, priority, or custom attributes. See Scripting Questions for more on item scripts.
MethodScopeConfiguration
Work item type default colorAll tasks of a typePolarion work item type settings
Item script color logicPer task, conditionalCustom item script with color return value
color / taskColor fieldPer task, from field valueMap a custom field to the task color property
The Gantt grid supports configurable columns with multiple template types including start date, end date, deadline, owner/assignees, duration, progress, and custom columns. The assignee column supports two display modes: initials (showing user initials in circles) and fullname (showing full names). A special workload column appears when you select a resource in the resource view.
Click the hamburger menu icon in the first column header of the Gantt grid. This opens a menu with options for column visibility, timescale selection, and navigation settings. You can show or hide columns and adjust the timescale granularity from this menu.
Yes, set the hideToolbar widget parameter to true to hide the entire toolbar. When the toolbar is hidden and you are in edit mode, a floating save button appears as a fallback so you can still save your changes.
When using hideToolbar, ensure users have an alternative way to access essential functions like save and refresh.
Set the onlyLeafTasks widget parameter to true to display only leaf-level tasks (tasks with no children). Parent summary tasks are hidden from the Gantt chart, giving you a flat view of all actionable work items without the hierarchical grouping.
The Gantt chart uses several visual indicators to communicate task status at a glance:
  • Progress fill — the filled portion of each task bar shows completion percentage
  • Overdue deadlines — deadline column values turn red when the task is past due
  • Risk indicator — tasks at risk (past end date) are highlighted with a warning color
  • Conflict markers — tasks with parent-child date range conflicts display a visual conflict indicator
  • Unplanned indicator — tasks with no scheduled dates appear with a special unplanned marker
For additional display customization, explore the Guides section.
These FAQs refer to widget parameters by their internal identifier (for example readonly, showResourceView, dependsRoles). In the Polarion page widget editor you set them through their Title Case labels — readonly appears as Read-only, showResourceView as Show Resource View, dependsRoles as Dependency Role, and so on. See Work Items Gantt Widget Parameters and Data Mapping Parameters for the full label-to-identifier reference.
Check the Reference section for detailed property documentation, or browse the Guides for step-by-step instructions. For additional support, submit a support ticket.
Last modified on July 10, 2026