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

# Create Tasks on the Timeline

> Enable work item creation in the Nextedy SCHEDULER widget and create scheduled work items directly on a resource row of the timeline.

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

By default a Scheduler board only plans work items that already exist -- you drag them onto the timeline from the Unplanned sidebar.
When the board is configured for it, you can also create a work item straight on the timeline: drag across the days it should cover, give it a title, and Scheduler creates a real Polarion work item that is already scheduled on that row.

## Prerequisites

* A Scheduler board on a Polarion Rich Page. See [Add the Scheduler Widget](/scheduler/guides/add-the-scheduler-widget) for placing and configuring the widget.
* The work item type you want to create must exist in the project.
* Permission to edit the page, because creation is switched on in the widget parameters.

<Steps>
  <Step title="Turn On Enable Create New">
    Open the page that hosts the board, click **Expand Tools**, then **Edit**.
    Select the Scheduler widget and choose **Edit widget parameters**.

    In the **Create New Work Item** section, set both parameters:

    | Parameter             | Default | What it does                                               |
    | --------------------- | ------- | ---------------------------------------------------------- |
    | **Enable Create New** | Off     | Allows drag-create and double-click-create on the timeline |
    | **Work Item Type**    | `task`  | The work item type Scheduler creates                       |

    Tick **Enable Create New**, confirm **Work Item Type**, then save the page.

    <Note>
      **Work Item Type** must hold a value.
      With no type selected, Scheduler leaves creation switched off even when **Enable Create New** is ticked.
    </Note>
  </Step>

  <Step title="Drag Across Empty Space on a Resource Row">
    Find the row of the resource that should own the task -- a user row in assignee mode, or an enumeration option row in enumeration mode.
    Press the mouse button on the first empty day cell of the row and drag horizontally across the days the task should cover.

    You can also **double-click** a single empty cell instead of dragging.

    <Tip>
      If the rows are collapsed, the summary row shows only the load heatmap and there is no empty space to drag across.
      Click **Expand rows** in the toolbar first.
      See [Navigate the Timeline](/scheduler/guides/navigate-the-timeline).
    </Tip>
  </Step>

  <Step title="Enter a Title and Save">
    The create dialog opens.
    It offers a single **Title** field and two buttons:

    * **Save** creates the work item with the title you typed.
    * **Cancel** closes the dialog and creates nothing.

    Type the title and click **Save**.

    <Frame>
      <img src="https://mintcdn.com/none-17b4493f/AuisNgWj2mZ3Ce9L/scheduler/assets/images/scheduler-create-task-dialog.png?fit=max&auto=format&n=AuisNgWj2mZ3Ce9L&q=85&s=5c8f87270a9352d42b91745c8a7e2860" alt="The Scheduler create dialog: a single Title field pre-filled with New event, and CANCEL and SAVE buttons underneath" width="1000" height="470" data-path="scheduler/assets/images/scheduler-create-task-dialog.png" />
    </Frame>
  </Step>

  <Step title="Check the Result on the Board">
    The new card appears on the row you dragged on, spanning the dates you dragged.
    It is a real Polarion work item of the configured type -- the work item ID on the card links to it, and the footer's **Scheduled** count goes up by one.

    <Frame>
      <img src="https://mintcdn.com/none-17b4493f/AuisNgWj2mZ3Ce9L/scheduler/assets/images/scheduler-created-task.png?fit=max&auto=format&n=AuisNgWj2mZ3Ce9L&q=85&s=169e60e0e84bd599504d5c3d245ed818" alt="Scheduler board showing a newly created task bar labelled SCHE-534 on the Melanie Test row, spanning the days that were dragged; the footer reads Items loaded: 26 / Scheduled: 3" width="1500" height="1229" data-path="scheduler/assets/images/scheduler-created-task.png" />
    </Frame>

    The new work item carries no estimate yet, so it adds nothing to the per-day load markers on that row until you give it one in Polarion.
    See [Capacity and Load](/scheduler/concepts/capacity-and-load) for how the markers are calculated.
  </Step>
</Steps>

## What Scheduler Writes to the New Work Item

Creating on the timeline fills in exactly four things:

| On the new work item | Comes from                                                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Type                 | The **Work Item Type** parameter                                                                                          |
| Title                | The **Title** field of the create dialog                                                                                  |
| Schedule             | The date fields configured under **Data Mapping** (Start Field, End Field, Duration Field), set from the span you dragged |
| Resource             | The row you dropped on -- the assignee in assignee mode, or the swimlane enumeration field in enumeration mode            |

Scheduler does not fill any other field.
Everything else on the work item stays as Polarion created it, so open the work item in Polarion to complete description, priority, links and the rest.

See [Dates, Duration and Effort](/scheduler/concepts/dates-duration-and-effort) for which combination of mapped fields carries the schedule, and [Swimlanes and Resources](/scheduler/concepts/swimlanes-and-resources) for how a row maps to a resource.

## There Is No Save Control

The Scheduler toolbar has no Save button.
Creating a task -- like moving one or linking two -- is written to Polarion as soon as you confirm it, so there is nothing to save afterwards and nothing to discard once the create dialog is closed with **Save**.

## Removing a Task You Created

The create dialog has no delete control, and neither does the card.
The card's **Unplan item** handle clears the schedule instead:

* The task disappears from the timeline and its card returns to the **Unplanned** sidebar.
* The work item itself is **not** deleted -- only its planned dates are cleared.
* There is no confirmation dialog.

So if you created a task by accident, **Unplan item** takes it off the board but leaves the work item behind.
Delete the work item itself in Polarion, the same way as any other work item.

<Warning>
  **Unplan item** takes effect immediately and without a prompt.
  Because there is no Save step, there is also no undo on the board -- drag the card back onto a row, or fix the dates on the work item, to restore the schedule.
</Warning>

See [Schedule and Reschedule Tasks](/scheduler/guides/schedule-and-reschedule-tasks) for the full planning and unplanning cycle.

## Verification

After enabling creation you should see:

1. Dragging across empty cells on a resource row starts a selection instead of doing nothing.
2. Releasing the mouse opens the create dialog with a single **Title** field, **Cancel** and **Save**.
3. **Save** produces a card on that row, with the work item ID linking to a real work item of the configured type.
4. The footer count **Scheduled** increases by one.
5. **Cancel** leaves the board unchanged -- no card, no work item.

If nothing happens when you drag, re-open the widget parameters and confirm that **Enable Create New** is ticked and **Work Item Type** is set.

## See Also

* [Schedule and Reschedule Tasks](/scheduler/guides/schedule-and-reschedule-tasks) -- plan existing items from the sidebar and move them around
* [Link Task Dependencies](/scheduler/guides/link-task-dependencies) -- connect the new task to its predecessors
* [Add the Scheduler Widget](/scheduler/guides/add-the-scheduler-widget) -- where the widget parameters live
* [Widget Parameters](/scheduler/reference/widget-parameters) -- every parameter with its default
* [Dates, Duration and Effort](/scheduler/concepts/dates-duration-and-effort) -- how the mapped fields store a schedule

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