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

# Frequently Asked Questions

> Find answers to the questions that come up most often when planning work on a Nextedy SCHEDULER board.

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

<div className="nx-faq-hub">
  <AccordionGroup>
    <Accordion title="General" description="Changing a task's duration, saving, empty boards, swimlane errors, the Time Points row, unplanning, and load over 100%." icon="circle-question">
      <AccordionGroup>
        <Accordion title="Why can't I stretch a task bar to change its duration?">
          Because task bars cannot be resized.
          They carry no resize handles, and dragging a bar's edge does exactly what dragging its middle does: it **moves the whole bar** and keeps its length.

          A task's length is a property of the work item, not of the board, so you change it in the fields the widget's **Data Mapping** points at:

          | Your Data Mapping                                            | Change the duration by                                               |
          | ------------------------------------------------------------ | -------------------------------------------------------------------- |
          | **Start Field** + **End Field** (the out-of-the-box mapping) | Editing the mapped end date -- or the start date -- on the work item |
          | **Start Field** + **Duration Field**                         | Editing the mapped duration field                                    |
          | **End Field** + **Duration Field**                           | Editing the mapped duration field                                    |

          Click a card's body to open that work item in Polarion's **Work Item Prop.** sidebar next to the board, edit the field there, then click **Refresh data** on the toolbar to redraw the bar at its new length.

          There is a useful side effect of bars not being resizable: dragging can never silently change how long a task takes.
          The full procedure is in [Schedule and Reschedule Tasks](/scheduler/guides/schedule-and-reschedule-tasks).
        </Accordion>

        <Accordion title="Where is the Save button?">
          There isn't one, and the board does not need one: **every change is written back to Polarion the moment you finish the gesture.**

          That covers every editing action on the board -- dragging a bar to new dates, dropping an item from the **Unplanned** sidebar onto a row, unplanning an item, creating a work item on the timeline, and adding or removing a dependency link.

          <Warning>
            Because there is no Save step, there is no Cancel step either.
            An accidental drag is a real change to the work item's dates.
            To undo it, make the opposite change: drag the bar back, or drag the item out of the sidebar again.
          </Warning>

          Two things follow from this:

          * **If you are unsure whether a change landed**, click **Refresh data**. The board reloads from the server, so what you see afterwards is what is stored.
          * **Widget configuration behaves differently.** Parameter changes are part of the Polarion page: they are made in page edit mode and saved with the page. See [Add the Scheduler Widget](/scheduler/guides/add-the-scheduler-widget).
        </Accordion>

        <Accordion title="Why does my board look empty?">
          An empty board is not an error state and Scheduler does not display a message about it -- the rows and day columns are drawn as usual, with nothing on them.

          <Frame caption="A board whose query matched nothing: rows and day columns are still drawn, the sidebar reads `0 work items`, and the only evidence is the footer's `Items loaded: 0`.">
            <img src="https://mintcdn.com/none-17b4493f/AuisNgWj2mZ3Ce9L/scheduler/assets/images/scheduler-empty-board.png?fit=max&auto=format&n=AuisNgWj2mZ3Ce9L&q=85&s=87f1526f2d98371503140a8eb16f1f33" alt="Scheduler board with no content: seven empty user swimlane rows, day columns from Aug 03 onward, an Unplanned sidebar reading 0 work items, and a footer reading Items loaded: 0 / Scheduled: 0 with an empty Timeline range" width="1500" height="1229" data-path="scheduler/assets/images/scheduler-empty-board.png" />
          </Frame>

          Read the footer first, because it tells you which of four different situations you are in:

          | What the footer says                                  | What it means                                             | What to do                                                                                                                                                     |
          | ----------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
          | `Items loaded: 0 / Scheduled: 0`                      | The query matched no work items at all                    | Check the widget's query. See [Add the Scheduler Widget](/scheduler/guides/add-the-scheduler-widget)                                                           |
          | `Items loaded: N / Scheduled: 0`                      | Work items were found, but none of them has dates yet     | They are all waiting in the backlog. Turn on **Show unscheduled items in sidebar** and drag them onto a row                                                    |
          | `Items loaded: N / Scheduled: M`, but no bars in view | The scheduled tasks fall outside the days currently drawn | Compare the footer's **Timeline range** with your tasks' dates, click **Scroll to today**, and widen the window with the Days Back and Days Forward parameters |
          | The board has a field error instead of rows           | The swimlane configuration is not valid                   | See the enumeration-field question below                                                                                                                       |

          <Tip>
            If there are no rows at all in assignee mode, the **User Role** parameter is the thing to check: out of the box it is `project_user`, so only users holding that role in the project get a row.
            Clear it to give every project user a row.
            See [Configure Swimlanes](/scheduler/guides/configure-swimlanes).
          </Tip>
        </Accordion>

        <Accordion title="Why do my enumeration swimlanes show a field error instead of rows?">
          Because **Field ID** names a field that Scheduler cannot use as a row, and the board reports that in place of the rows rather than falling back to a default.

          There are two ways to land there:

          * **You switched to Enumeration Field without changing Field ID.** The parameter arrives pre-filled with `team`, and that is only a valid setting if your project actually has a `team` enumeration. If it does not, the board reports that the field `team` does not exist or is not of type enumeration.
          * **You entered a field that is not an enumeration, or one that Scheduler rejects.** `status`, `resolution` and `type` are rejected with a message that the field is not supported as a swimlane, even though they look like enumerations on a work item form.

          | What you enter in Field ID                            | What the board does                                   |
          | ----------------------------------------------------- | ----------------------------------------------------- |
          | An enumeration field that exists on your work items   | Draws one row per option of that enumeration          |
          | `status`, `resolution` or `type`                      | Rejects it as not supported as a swimlane             |
          | A field that does not exist, or is not an enumeration | Rejects it as not existing or not of type enumeration |

          The fix is the same in both cases: set **Field ID** to the ID of an enumeration field that exists on the work item types your query returns -- the technical field ID from Polarion, not the label shown on the form -- then reload the board.
          [Configure Swimlanes](/scheduler/guides/configure-swimlanes) walks through both swimlane modes.
        </Accordion>

        <Accordion title="Why is there no Time Points row on my board?">
          Because the row is populated from **legacy Polarion time points**, and there are none in your window.

          The **Show Time Points** parameter in the widget's **Advanced** panel is on out of the box, but the row is drawn only when there is at least one such time point inside the timeline window.
          Current Polarion versions plan with Plans -- iterations and releases -- and those do not feed this row, so on a current Polarion server leaving **Show Time Points** on does not add a row.

          Nothing is misconfigured when the row is absent, and nothing else on the board depends on it: the row only ever showed read-only date landmarks alongside your bars, never anything schedulable.
          For date orientation, use the current-date line and **Scroll to today** instead, described in [Navigate the Timeline](/scheduler/guides/navigate-the-timeline).

          See [Swimlanes and Resources](/scheduler/concepts/swimlanes-and-resources) for what the row contains when it does appear.
        </Accordion>

        <Accordion title="Why does clicking a swimlane name do nothing?">
          Row names on the board are rendered as links, but the link has no real target -- clicking one opens a new browser tab on a dead URL and changes nothing on the board itself.

          To narrow your view to a single resource, use the **Unplanned** sidebar's funnel filter instead: its **Swimlanes** submenu lists the board's resources, and picking one filters the backlog to the items belonging to that row.
          The sidebar's count then reads as `N out of M work items`, and clearing the filter with the **Unplanned** entry brings the full backlog back.

          [Filter the Unplanned Sidebar](/scheduler/guides/filter-the-unplanned-sidebar) covers the funnel filter, the saved queries it offers, and the free-text search next to it.
        </Accordion>

        <Accordion title="What happens to the work item when I unplan it?">
          Only its schedule is removed.
          **Unplan item** -- the calendar-with-a-cross handle that appears when you hover a card -- clears the task's mapped date fields, and its mapped duration field if one is configured.
          There is no confirmation prompt.

          Everything else about the work item is untouched: its title, its type, its assignee, its links, its history, its attachments.
          The item itself still exists in Polarion, and it reappears as a card under **Unplanned** with the footer's scheduled count down by one and the sidebar's item count up by one.
          Drag it back onto a row whenever you want to schedule it again.

          <Warning>
            **Unplan item** is not a delete.
            Deleting a work item remains a Polarion operation, done from the work item itself -- Scheduler offers no way to do it.
          </Warning>

          The reverse is worth knowing too: dropping a card from the sidebar onto a row both schedules the item and assigns it to that row's resource.
          See [Schedule and Reschedule Tasks](/scheduler/guides/schedule-and-reschedule-tasks).
        </Accordion>

        <Accordion title="Why does a day show more than 100% load?">
          Because more effort is scheduled against that row on that day than the row's daily capacity, which is exactly what the red band is there to tell you.

          Load markers read `load / capacity` in hours, so a marker of `15.3 / 8` means over fifteen hours of work are scheduled against an eight-hour day.
          The number arrives like this:

          1. Every task bar covering that day in that row contributes a share of its effort.
          2. A task's effort is spread evenly across the working days its bar spans, so a five-day bar carrying 20 hours contributes 4 hours a day.
          3. The shares of all the bars in the row are added together for that day.

          So an overload has two possible causes, and they call for different responses:

          * **Too many tasks on the same days.** Move one of the bars to a quieter stretch of the timeline.
          * **One task given too few days.** Lengthen it through the mapped duration or end-date field -- the same estimate spread over ten days instead of five halves its daily contribution.

          <Note>
            Check the denominator before reading the colour.
            User rows are measured against an eight-hour day and enumeration rows against a 24-hour day, so `12 / 24` on a team row and `12 / 8` on a user row hold the same amount of work while only the second is an overload.
          </Note>

          A task that pushes a day over capacity is also drawn red itself, ahead of the colour its work-item status would otherwise give it.
          A red bar therefore has two possible readings -- over capacity, or past the work item's due date -- and the card's hover tooltip tells you which: an overdue task adds a red **Overdue** line with the due date.
          [Capacity and Load](/scheduler/concepts/capacity-and-load) covers the calculation, and [Colours and Load Thresholds](/scheduler/reference/colours-and-load-thresholds) lists the four load bands and the order the card colours are applied in.
        </Accordion>
      </AccordionGroup>
    </Accordion>
  </AccordionGroup>
</div>

<Tip title="Can't find your answer?">
  The [Concepts](/scheduler/concepts/index) section explains how the board reads and writes Polarion data, the [Guides](/scheduler/guides/index) section gives step-by-step procedures, and the [Reference](/scheduler/reference/index) section lists every parameter, toolbar control and colour.
  If your question is still unanswered, raise it at [support.nextedy.com](https://support.nextedy.com).
</Tip>

<LastReviewed date="2026-08-05" />
