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

# Configuration Questions

> Common questions about configuring Nextedy GANTT widget parameters, administration properties, and display settings.

<Info title="Verify in application">
  This page provides an overview of configuration concepts. Refer to the [Reference](/gantt/reference/index) section for complete property documentation.
</Info>

<AccordionGroup>
  <Accordion title="What is the difference between widget parameters and administration properties?">
    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 Level     | Scope                  | Set Where                     | Example                                 |
    | ----------------------- | ---------------------- | ----------------------------- | --------------------------------------- |
    | Widget parameter        | Per widget instance    | Polarion page widget editor   | `showResourceView`, `readonly`          |
    | Administration property | Project or server-wide | Polarion Administration panel | `nextedy.gantt.default.auto_scheduling` |
  </Accordion>

  <Accordion title="How do I set up field mappings for the Gantt chart?">
    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.

    <Warning title="Required field mappings">
      You must configure at least two of `startField`, `endField`, and `durationField`. The Gantt widget will not render without a valid field mapping combination.
    </Warning>
  </Accordion>

  <Accordion title="How do I configure dependency link roles?">
    Set the **Dependency Role** parameter (`dependsRoles`) to specify which Polarion link role IDs represent finish-to-start dependencies between tasks. Work items connected with these link roles appear as dependency arrows in the Gantt chart. Similarly, use **Parent Role** (`parentRoles`) to define which link roles represent parent-child hierarchical relationships displayed in the Gantt tree structure.
  </Accordion>

  <Accordion title="How do I configure the Gantt to show a specific work item type?">
    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](/gantt/reference/widget-parameters/work-items-gantt) 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**.

    <Info title="Verify in application">
      The exact work item type IDs available depend on your Polarion project configuration. Check your project's work item type definitions.
    </Info>
  </Accordion>

  <Accordion title="Can I make the Gantt chart read-only?">
    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.
  </Accordion>

  <Accordion title="How do I configure the resource field for task assignment?">
    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](/gantt/getting-started/setup-basic-gantt) and the [Reference](/gantt/reference/index) documentation.
  </Accordion>
</AccordionGroup>