> ## 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.

# General Administration Properties

> Nextedy GANTT provides global administration properties that control core behavior, scheduling defaults, and display options across all Gantt chart instances.

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>;
};

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/umKaPvHwUHw-ZQFM/gantt/diagrams/reference/configuration/general-properties/diagram-1.svg?fit=max&auto=format&n=umKaPvHwUHw-ZQFM&q=85&s=1409ce4dc9d13040d06a6f7983e26f35" alt="diagram" style={{ maxWidth: "820px", width: "100%" }} width="820" height="70" data-path="gantt/diagrams/reference/configuration/general-properties/diagram-1.svg" />
</Frame>

## General Behavior Properties

| Name                                              | Type    | Default    | Description                                                                                                                                                                                                                |
| ------------------------------------------------- | ------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nextedy.gantt.debug`                             | Boolean | `false`    | Enables client-side debug messages in the browser console.                                                                                                                                                                 |
| `nextedy.gantt.default.auto_scheduling`           | Boolean | `false`    | Toggles auto-scheduling by default. When enabled, dependent tasks are automatically rescheduled when a predecessor changes.                                                                                                |
| `nextedy.gantt.default.critical_path`             | Boolean | `false`    | Toggles visualization of the critical path by default.                                                                                                                                                                     |
| `nextedy.gantt.config.squareTaskBorder`           | Boolean | `false`    | Switches task bar borders from rounded to square. Set `true` in Configuration Properties to apply globally, or in the Gantt Config Script for a specific page. A `false` in Gantt Config Script overrides a global `true`. |
| `nextedy.gantt.config.scheduleUnplannedTasksMode` | Enum    | `parent`   | Defines behavior for scheduling unplanned children. `parent` -- unscheduled children align with the parent start date. `today` -- unscheduled children are scheduled to today's date.                                      |
| `nextedy.gantt.sort_children_by_id`               | Boolean | `false`    | When `true`, child work items are sorted by ID instead of the default sorting based on the `Sort by` widget parameter.                                                                                                     |
| `nextedy.gantt.assignee_column_display_mode`      | Enum    | `initials` | Controls the presentation of the assignee column: `initials` (circle with user initials) or `fullname` (full display name).                                                                                                |
| `nextedy.gantt.classic_project`                   | Boolean | `false`    | Uses the classic visual style for project (summary) item types.                                                                                                                                                            |

## Zoom Column Width Properties

These properties control the pixel width of timeline columns at each zoom scale level:

| Name                                     | Type    | Default | Description                                     |
| ---------------------------------------- | ------- | ------- | ----------------------------------------------- |
| `nextedy.gantt.zoom.DD.min_column_width` | Integer | `120`   | Column width in the DD (bi-daily) scale mode.   |
| `nextedy.gantt.zoom.D.min_column_width`  | Integer | `60`    | Column width in the D (daily) scale mode.       |
| `nextedy.gantt.zoom.W.min_column_width`  | Integer | `30`    | Column width in the W (weekly) scale mode.      |
| `nextedy.gantt.zoom.M.min_column_width`  | Integer | `70`    | Column width in the M (monthly) scale mode.     |
| `nextedy.gantt.zoom.Q.min_column_width`  | Integer | `90`    | Column width in the Q (quarterly) scale mode.   |
| `nextedy.gantt.zoom.Y.min_column_width`  | Integer | `40`    | Column width in the Y (yearly) scale mode.      |
| `nextedy.gantt.zoom.YY.min_column_width` | Integer | `190`   | Column width in the YY (multi-year) scale mode. |

For a complete list of zoom levels and their behaviors, see [Zoom and Scale Levels Reference](/gantt/reference/zoom-scale-levels).

## Work Items Gantt Default Properties

These properties define default values for Work Items Gantt widget parameters. They apply when a new widget is added to a page. **Once the widget is saved, the widget's own parameter values take precedence.**

| Name                                                    | Type    | Default          | Description                                                                               |
| ------------------------------------------------------- | ------- | ---------------- | ----------------------------------------------------------------------------------------- |
| `nextedy.gantt.workitems.default.sort_by`               | String  | `id`             | Default value for the **Sort By** widget parameter.                                       |
| `nextedy.gantt.workitems.default.expand_level`          | Integer | `0`              | Default value for **Load Children** -- number of child levels to add to the dataset.      |
| `nextedy.gantt.workitems.default.show_unplanned`        | Boolean | `true`           | Default value for **Show Unplanned**.                                                     |
| `nextedy.gantt.workitems.default.scale`                 | String  | `W`              | Default value for **Scale** (timeline zoom level).                                        |
| `nextedy.gantt.workitems.default.parent_link_roles`     | String  | *empty*          | Default value for **Parent Link Roles**. A semicolon-separated list of link role IDs.     |
| `nextedy.gantt.workitems.default.dependency_link_roles` | String  | *empty*          | Default value for **Dependency Link Roles**. A semicolon-separated list of link role IDs. |
| `nextedy.gantt.workitems.default.start_field`           | String  | `gantt_start`    | Default value for **Start Field**.                                                        |
| `nextedy.gantt.workitems.default.end_field`             | String  | *none*           | Default value for **End Field**.                                                          |
| `nextedy.gantt.workitems.default.duration_field`        | String  | `gantt_duration` | Default value for **Duration Field**.                                                     |
| `nextedy.gantt.workitems.default.progress_field`        | String  | `gantt_progress` | Default value for **Progress Field**.                                                     |
| `nextedy.gantt.workitems.default.maximize_view`         | Boolean | `false`          | Default value for **Maximize Gantt 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 value for **Max Items** -- limits the number of work items loaded.                |
| `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 legacy working time mode.                                               |
| `nextedy.gantt.workitems.resolved_readonly`             | Boolean | `true`           | When `true`, prevents moving resolved items on the Gantt chart.                           |

## Global-Only Work Items Properties

These properties can only be set globally and are not configurable per widget instance:

| Name                                                 | Type    | Default | Description                                                                                                                               |
| ---------------------------------------------------- | ------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `nextedy.gantt.workitems.default.forward_dependency` | Boolean | `false` | Reverses the dependency link direction. Set to `true` if you link tasks from B to A instead of the default A to B (where A depends on B). |
| `nextedy.gantt.workitems.default_duration`           | Integer | `10`    | Default task duration in days when no duration is specified on the work item.                                                             |
| `nextedy.gantt.workitems.default.link_lag`           | Integer | `0`     | Default lead/lag time for dependency links.                                                                                               |
| `nextedy.gantt.multiAssignmentSameEffortForAll`      | Boolean | `true`  | When `true`, the effort is the same for all assignees in a multi-assignment. When `false`, the effort is shared across assignees.         |

## Plans Gantt Default Properties

These properties define default values for Plans Gantt widget parameters:

| Name                                            | Type    | Default | Description                                         |
| ----------------------------------------------- | ------- | ------- | --------------------------------------------------- |
| `nextedy.gantt.plans.default.sort_by`           | String  | `id`    | Default value for the **Sort By** widget parameter. |
| `nextedy.gantt.plans.default.expand_level`      | Integer | `0`     | Default value for **Load Children**.                |
| `nextedy.gantt.plans.default.show_unplanned`    | Boolean | `true`  | Default value for **Show Unplanned**.               |
| `nextedy.gantt.default.plans.scale`             | String  | `W`     | Default value for **Scale**.                        |
| `nextedy.gantt.plans.default.maximize_view`     | Boolean | `false` | Default value for **Maximize View**.                |
| `nextedy.gantt.plans.default.hide_toolbar`      | Boolean | `false` | Default value for **Hide Toolbar**.                 |
| `nextedy.gantt.plans.default.progress_coloring` | Boolean | `true`  | Default value for **Progress Coloring**.            |
| `nextedy.gantt.plans.default.drag_children`     | Boolean | `true`  | Default value for **Drag Children**.                |

<Info title="Verify in application">
  Additional Plans Gantt default properties (such as `max_items`) may be available. Verify the complete list of Plans Gantt defaults in your Gantt version.
</Info>

## Calendar and Resource Properties

The following properties configure working calendar and resource resolution. For the full calendar property reference, see [Calendar and Working Hours Properties](/gantt/reference/configuration/calendar-properties). For team configuration, see [Team and Resource Properties](/gantt/reference/configuration/team-properties).

| Name                                       | Type    | Default         | Description                                                                            |
| ------------------------------------------ | ------- | --------------- | -------------------------------------------------------------------------------------- |
| `nextedy.gantt.workitemCalendar.projectId` | String  | See application | The Polarion project ID where working calendar work items are stored.                  |
| `nextedy.gantt.workitemCalendar.globalID`  | String  | See application | The work item ID of the global working calendar used as the default for all resources. |
| `nextedy.gantt.calendarHolder`             | String  | See application | The Polarion user ID whose calendar work item is used as the global working calendar.  |
| `nextedy.gantt.workingCalendar.useCache`   | Boolean | See application | Enables server-side caching of working calendar data for performance.                  |
| `nextedy.gantt.loadResourcesFromCsv`       | Boolean | See application | Enables loading resource definitions from a CSV file instead of Polarion users.        |
| `nextedy.gantt.useTeamCapacityModifiers`   | Boolean | See application | Enables team-level capacity modifiers for resource allocation.                         |
| `nextedy.gantt.phantomResourceHoursPerDay` | Integer | See application | Default working hours per day for unresolvable (phantom) resources.                    |

## Configuration Example

To enable auto-scheduling and critical path visualization globally:

1. Navigate to **Administration > Configuration Properties**.
2. Add the following properties:
   ```
   nextedy.gantt.default.auto_scheduling=true
   nextedy.gantt.default.critical_path=true
   ```
3. Save the configuration.

All new Gantt widgets added to pages will have auto-scheduling and critical path enabled by default. Existing widgets retain their saved parameter values.

## Related Pages

* [Color and Styling Properties](/gantt/reference/configuration/color-properties) -- progress colors and resource marker colors
* [Calendar and Working Hours Properties](/gantt/reference/configuration/calendar-properties) -- working calendar configuration
* [Team and Resource Properties](/gantt/reference/configuration/team-properties) -- team assignment and capacity modifiers
* [Default Configuration Values](/gantt/reference/configuration/default-values) -- complete default value reference
* [Widget Parameters](/gantt/reference/widget-parameters/index) -- per-instance widget parameters

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