Set and change start and finish dates of work packages

Feature Documentation for
Set start and finish dates How to set start and finish dates, and how to change them
Scheduling mode Enabling manual scheduling and what it does
Information and warning banners What the different warning and information banners mean

Set start and finish dates

You can change the start and finish dates of work packages by opening the date picker.

The standard date picker

  1. Manual scheduling checkbox
  2. Start and finish date input fields
  3. Mini calendars for date range preview
  4. Save and cancel buttons

You can open the date picker for a work package from a number of different places:

Using the date picker

You can enter dates either by typing them in into the start and finish date fields or by clicking on individual dates in the mini calendar below.

Note: Typed dates need to be in the standard ISO 8601 format: YYYY-MM-DD (so 12 October 2022 would be 2022-10-12).

They will nevertheless be displayed in your desired format (usually depending by your region or language).

You can also click on the Today link below the start and finish date fields to use today’s date.

A more intuitive way to select start and end dates is to simply click on two different dates in the mini calendars below. Two calendar months are displayed to give you more visibility.

Start by clicking on a start date. This will enter the selected date as the start date, mark it with a dark color on the mini calendar below and move the focus automatically to the finish date. Hovering on different finish dates will give you a preview of which date are included if you click this second date. Once you have decided on a finish date, click on it to select it. This will enter the finish date in the date field and mark the end date with another dark color.

To confirm the selected dates, click on the Save button. The green message on top of the work package indicates a successful update.

A green toast indicating successful update

To clear a date field, simply click on the clear icon (“×”) icon when the field is in focus.

A focused date field has an X to clear it

Date changes are documented in the work package Activity.

Advanced functionality

  • The date picker allows you to pick start and finish dates in the opposite order. Clicking on a start date and then moving backwards to click on an earlier date will then use that first date as the finish date and the second (earlier) date as the start date.

  • Once you have selected your start and finish dates, you can adjust either field without resetting the other one by clicking on a new date near the previously selected date. This, however, depends on which date field is in focus. For example, clicking on a new start date that is 2 days earlier when the start date field is in focus simply replaces the original start date (conserving the finish date). However, clicking on that same date when the finish date field is in focus clears the finish date and uses the clicked date as the new start date. A second click then allows to select the new finish date.

One-day events

If you want the work package to start and end on the same date, simply click the same date twice.

Date picker with the same start and finish dates

Work packages with only a start date or only a finish date are automatically considered as one-day events.

Certain work package types (such as Milestones) can only span one day and thus have only one date field:

Milestones have datpickers with a single date field

Scheduling mode

Manual scheduling

Datepicker with a checkbox to enable manual scheduling

Checking “Manual scheduling” enables manual scheduling mode for the work package. This ignores work package relations such that you’re able to select any start and end dates, even ones that would normally be restricted due to follows/proceeds relationships.

Manual scheduling also decouples the start and end dates of parent and children work packages. This means that the dates of parents are no longer constrained by those of the children, and children can be scheduled outside of the range of parent work packages. These relationships are completely ignored as far as scheduling is concerned.

Manual scheduling can be useful when you need to anchor a work package to fixed dates, for example because the dates of preceding or following work packages are not yet known.

Information and warning banners

OpenProject 12.2 introduced helpful banners to give you important contextual information when changing dates on work packages with relations.

Information banners have a blue background and display information that is helpful to the user but is not critical. Warning banners have an orange background and display information that is critical, with potentially larger consequences to project scheduling.

There are four possible banners:

Automatically scheduled

A blue banner informing the user that the worked package is automatically scheduled

This information banner is displayed when the dates of the current work package are derived from existing relations and can therefore not be modified. This is the case of parent work packages whose start and finish dates are derived from the earliest and latest child work packages respectively.

It is nevertheless possible to input specific start and finish dates for such work packages by enabling manual scheduling (which will ignore relations from which the dates were originally derived).

Available start date and finish dates limited by relations.

A blue banner informing the user that certain dates are limited by relations

This information banner is displayed when certain date ranges are disabled due to constraints imposed by follows/precedes relations. For example, a work packages following another one cannot be scheduled before the finish date of the the preceding one.

Manually scheduled, relations ignored

An orange banner warning the user that manual scheduling will ignore existing relations

This warning banner is displayed when you enable manual scheduling on work packages that have follows/precedes or parent/child relations, which are now ignored and no longer limit which dates can be selected for this work package. This also means that changes a manually scheduled work package no longer affect others, despite those existing relations.

This banner is not displayed when manual scheduling is enabled on work packages without relations.

Other work packages affected

An orange banner warning the user that changing these dates will affect other the dates of work packages

This warning banner is displayed on work packages whose start and end dates affect those of other related work packages. For example, when changing the finish date will consequently change the start date of another (following) work package and/or the finish date of a parent.

Info: When both an information and a warning banner are applicable to a work package, only the more important warning banner is displayed.

Show Relations button

The Show Relations button in an information or warning banner

The information and warning banners also feature a Show Relations button. Clicking on this will open a new tab that displays work packages with direct relations to the current work package in Gantt view, in hierarchy mode.

Info: This preview is intended to give a quick overview of only direct relations that might affect scheduling options for the current work package. It does not show second-level relations (and above). To get a full overview, please use the project work package list view or Gantt view with your desired filter/view configuration.