> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Default Configuration Values

> Nextedy GANTT provides administration properties that set default values for widget parameters. These defaults apply when you add a new Gantt widget to a page.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

Set these properties in **Administration > Configuration Properties**.

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/XoCXinV6eKUe5dKK/gantt/images/48001074063/1.png?fit=max&auto=format&n=XoCXinV6eKUe5dKK&q=85&s=569c46ea8bdec8dfa4b999e178216a86" alt="Polarion Administration Configuration Properties page where Gantt default value properties are defined" width="1718" height="626" data-path="gantt/images/48001074063/1.png" />
</Frame>

<Tip title="Override Hierarchy">
  Administration defaults apply system-wide. Once a widget is placed on a page, its own parameter values override these defaults. User preferences (zoom level, column widths) are saved in the browser and override both.
</Tip>

## General Properties

| Name                                              | Type      | Default    | Description                                                                                                                                                                       |
| ------------------------------------------------- | --------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nextedy.gantt.workitems.unplanned_color`         | `String`  | `#7D3C98`  | Color of unplanned task bars.                                                                                                                                                     |
| `nextedy.gantt.today.color`                       | `String`  | `gray`     | Color of the today marker line.                                                                                                                                                   |
| `nextedy.gantt.classic_project`                   | `Boolean` | `false`    | Use the classic look for project item types.                                                                                                                                      |
| `nextedy.gantt.zoom.DD.min_column_width`          | `Integer` | `120`      | Timeline column width in DD (2-Day) scale mode.                                                                                                                                   |
| `nextedy.gantt.zoom.D.min_column_width`           | `Integer` | `60`       | Timeline column width in D (Day) scale mode.                                                                                                                                      |
| `nextedy.gantt.zoom.W.min_column_width`           | `Integer` | `30`       | Timeline column width in W (Week) scale mode.                                                                                                                                     |
| `nextedy.gantt.zoom.M.min_column_width`           | `Integer` | `70`       | Timeline column width in M (Month) scale mode.                                                                                                                                    |
| `nextedy.gantt.zoom.Q.min_column_width`           | `Integer` | `90`       | Timeline column width in Q (Quarter) scale mode.                                                                                                                                  |
| `nextedy.gantt.zoom.Y.min_column_width`           | `Integer` | `40`       | Timeline column width in Y (Year) scale mode.                                                                                                                                     |
| `nextedy.gantt.zoom.YY.min_column_width`          | `Integer` | `190`      | Timeline column width in YY (2-Year) scale mode.                                                                                                                                  |
| `nextedy.gantt.debug`                             | `Boolean` | `false`    | Enable client-side debug messages in the browser console.                                                                                                                         |
| `nextedy.gantt.default.auto_scheduling`           | `Boolean` | `false`    | Toggle auto-scheduling by default for new widgets.                                                                                                                                |
| `nextedy.gantt.default.critical_path`             | `Boolean` | `false`    | Toggle critical path visualization by default for new widgets.                                                                                                                    |
| `nextedy.gantt.config.squareTaskBorder`           | `Boolean` | `false`    | Switch task bar borders to square instead of rounded. Set `true` in Configuration Properties for global effect. Can be overridden per widget in Gantt Config Script.              |
| `nextedy.gantt.config.scheduleUnplannedTasksMode` | `String`  | `parent`   | Defines behavior for scheduling unplanned children. `parent` -- unscheduled children align with parent start date. `today` -- unscheduled children are scheduled to today's date. |
| `nextedy.gantt.sort_children_by_id`               | `Boolean` | `false`    | Sort child work items by ID instead of the default sorting based on the Sort By parameter.                                                                                        |
| `nextedy.gantt.assignee_column_display_mode`      | `String`  | `initials` | Presentation mode for the assignee column. Values: `initials` or `fullname`.                                                                                                      |

## Work Items Gantt Widget Defaults

These defaults apply to new Work Items Gantt widgets. Once a widget is added, its own parameter values are used.

| Name                                                    | Type      | Default          | Description                                                                     |
| ------------------------------------------------------- | --------- | ---------------- | ------------------------------------------------------------------------------- |
| `nextedy.gantt.workitems.default.sort_by`               | `String`  | `id`             | Default value for the Sort By parameter.                                        |
| `nextedy.gantt.workitems.default.expand_level`          | `Integer` | `0`              | Default value for Load Children. Specifies how many hierarchy levels to expand. |
| `nextedy.gantt.workitems.default.show_unplanned`        | `Boolean` | `true`           | Default value for Show Unplanned.                                               |
| `nextedy.gantt.workitems.default.scale`                 | `String`  | `W`              | Default zoom scale. Values: `H`, `DD`, `D`, `W`, `M`, `Q`, `Y`, `YY`.           |
| `nextedy.gantt.workitems.default.parent_link_roles`     | `String`  | *empty*          | Default parent link roles. Semicolon-separated list of link role IDs.           |
| `nextedy.gantt.workitems.default.dependency_link_roles` | `String`  | *empty*          | Default dependency link roles. Semicolon-separated list of link role IDs.       |
| `nextedy.gantt.workitems.default.start_field`           | `String`  | `gantt_start`    | Default Start Field mapping.                                                    |
| `nextedy.gantt.workitems.default.end_field`             | `String`  | *none*           | Default End Field mapping.                                                      |
| `nextedy.gantt.workitems.default.duration_field`        | `String`  | `gantt_duration` | Default Duration Field mapping.                                                 |
| `nextedy.gantt.workitems.default.progress_field`        | `String`  | `gantt_progress` | Default Progress Field mapping.                                                 |
| `nextedy.gantt.workitems.default.maximize_view`         | `Boolean` | `false`          | Default value for Maximize view.                                                |
| `nextedy.gantt.workitems.default.hide_toolbar`          | `Boolean` | `false`          | Default value for Hide Toolbar.                                                 |
| `nextedy.gantt.workitems.default.progress_coloring`     | `Boolean` | `true`           | Default value for Progress Coloring.                                            |
| `nextedy.gantt.workitems.default.drag_children`         | `Boolean` | `true`           | Default value for Drag Children.                                                |
| `nextedy.gantt.workitems.default.max_items`             | `Integer` | `100`            | Default maximum number of items loaded into the chart.                          |
| `nextedy.gantt.workitems.default.show_today_marker`     | `Boolean` | `true`           | Default value for Show Today Marker.                                            |
| `nextedy.gantt.workitems.default.working_time`          | `Boolean` | `true`           | Default value for working time mode.                                            |
| `nextedy.gantt.workitems.resolved_readonly`             | `Boolean` | `true`           | When `true`, resolved work items cannot be moved on the Gantt chart.            |

### Additional Defaults (Not Configurable Per Widget)

These properties control behavior at the server level and cannot be overridden on a specific widget instance.

| Name                                                 | Type      | Default | Description                                                                                                                 |
| ---------------------------------------------------- | --------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `nextedy.gantt.workitems.default.forward_dependency` | `Boolean` | `false` | Reverse dependency link direction. Set to `true` if you link tasks from B to A instead of A to B.                           |
| `nextedy.gantt.workitems.default_duration`           | `Integer` | `10`    | Default duration in days for items without a specified duration.                                                            |
| `nextedy.gantt.workitems.default.link_lag`           | `Integer` | `0`     | Default lead/lag time for dependency links.                                                                                 |
| `nextedy.gantt.multiAssignmentSameEffortForAll`      | `Boolean` | `true`  | When `true`, effort is the same for each assignee in multi-assignment mode. When `false`, effort is shared among assignees. |

## Plans Gantt Widget Defaults

These defaults apply to new Plans Gantt widgets.

| Name                                            | Type      | Default         | Description                            |
| ----------------------------------------------- | --------- | --------------- | -------------------------------------- |
| `nextedy.gantt.plans.default.sort_by`           | `String`  | `id`            | Default Sort By value.                 |
| `nextedy.gantt.plans.default.expand_level`      | `Integer` | `0`             | Default Load Children level.           |
| `nextedy.gantt.plans.default.show_unplanned`    | `Boolean` | `true`          | Default Show Unplanned value.          |
| `nextedy.gantt.default.plans.scale`             | `String`  | `W`             | Default zoom scale for Plans Gantt.    |
| `nextedy.gantt.plans.default.maximize_view`     | `Boolean` | `false`         | Default Maximize view value.           |
| `nextedy.gantt.plans.default.hide_toolbar`      | `Boolean` | `false`         | Default Hide Toolbar value.            |
| `nextedy.gantt.plans.default.progress_coloring` | `Boolean` | `true`          | Default Progress Coloring value.       |
| `nextedy.gantt.plans.default.drag_children`     | `Boolean` | `true`          | Default Drag Children value.           |
| `nextedy.gantt.plans.default.max_items`         | `Integer` | See application | Default maximum items for Plans Gantt. |

## Default Client-Side Values

The Gantt widget ships with these built-in client-side defaults:

| Setting                        | Default                                 | Description                                                                          |
| ------------------------------ | --------------------------------------- | ------------------------------------------------------------------------------------ |
| Default zoom scale             | `W` (Week)                              | Users see a weekly timeline when first loading the chart without a saved preference. |
| Default undo steps             | `10`                                    | Maximum undo/redo operations in a single edit session.                               |
| Default work item types        | `feature`, `workpackage`, `release`     | Three built-in work item types with preset display modes.                            |
| Default working calendar       | Mon-Fri, 8 hours/day                    | Standard 5-day work week.                                                            |
| Default resource marker colors | Green `#4CAF50` (ok), Red/Orange (over) | Color-coding for resource allocation markers.                                        |
| Range conflict detection       | `false`                                 | Must be explicitly enabled.                                                          |

## Configuration Example

To customize defaults for a Work Items Gantt deployment:

```properties theme={null}
nextedy.gantt.workitems.default.scale=M
nextedy.gantt.workitems.default.max_items=200
nextedy.gantt.workitems.default.progress_coloring=true
nextedy.gantt.workitems.default.start_field=plannedStart
nextedy.gantt.workitems.default.end_field=plannedEnd
nextedy.gantt.workitems.default.duration_field=
nextedy.gantt.default.auto_scheduling=true
nextedy.gantt.assignee_column_display_mode=fullname
```

## Related Pages

* [General Administration Properties](/gantt/reference/configuration/general-properties) -- global non-default properties
* [Color and Styling Properties](/gantt/reference/configuration/color-properties) -- color configuration
* [Work Items Gantt Widget Parameters](/gantt/reference/widget-parameters/work-items-gantt) -- per-widget parameter reference
* [Plans Gantt Widget Parameters](/gantt/reference/widget-parameters/plans-gantt) -- per-widget Plans Gantt parameters
* [Zoom and Scale Levels Reference](/gantt/reference/zoom-scale-levels) -- zoom level codes and column widths

<LastReviewed date="2026-07-07" />