Skip to main content
Most Scheduler boards need nothing more than a query, swimlanes, and a date mapping. The parameters on this page cover the rest: how wide a date window the board shows, what a task tooltip lists, and the two script hooks that let you adapt individual cards and the board’s configuration. They all live in the widget’s parameter editor, so you need edit rights on the page that holds the board.

​
Open the widget parameters

1

Open the page that holds the board

Navigate to the page that holds the Scheduler board. In a project created from the Scheduler demo template, that is the Scheduler entry in the project navigation.
2

Switch the page into edit mode

Expand Tools in the page toolbar, then click Edit.
3

Open the widget's parameters

Select the Scheduler widget on the page, then choose Edit widget parameters. The parameter panels appear, one composite panel per group.
4

Open the panel you need

Advanced holds the date window, the two script fields, and several display settings. It is collapsed by default — click its header to open it.Tooltip Fields is not in Advanced; it sits in the Work Items panel next to the query.
5

Apply your changes

Confirm the parameter editor and save the page. The board reloads with the new configuration.
Editing parameters changes the board for everyone. Widget parameters are part of the page, so a change you save applies to every user who opens it. The zoom level and the active view, by contrast, are per-user browser settings — see Navigate the Timeline.

​
Set the date window with Days Back and Days Forward

A Scheduler board always shows a window around today. It starts Days Back days before today and ends Days Forward days after today, and the resulting dates are shown in the footer as Timeline range. Pick the window to match how the board is used. A sprint or maintenance board is easier to read at 10 days back and 30 to 60 days forward; a release-planning board needs a longer forward window.
An unset Days Forward falls back to a shared default, not to its own value. Both fields take their default from the same project configuration property, nextedy.scheduler.days_back; only when that property is unset do they fall back to their own built-in values of 10 and 100. If an administrator sets that property, the value becomes the default for Days Back and Days Forward alike. Type an explicit number into Days Forward whenever the forward window matters — an explicit value is always used exactly as entered.
Zooming does not change this window; it only changes how much of the window fits on screen. See Board and Timeline for how the window and the day grid relate.

​
Choose what a task tooltip shows

Hovering a task bar shows a tooltip with the work item’s title in bold, the task’s start and end dates, and then one line per field listed in Tooltip Fields. When the task is overdue, a red Overdue line with the due date is added. Tooltip Fields lives in the Work Items panel and defaults to four fields: Project, Type, Status, and Assignee(s).
A Scheduler task tooltip showing the bold work-item title DP-39 - Some Project Management Plan Task, a date range of Jul 31, 2026 to Aug 04, 2026, and four field lines reading Project, Type, Status and Assignee(s)

The default tooltip: the work item's title, its date range, and the four fields listed in Tooltip Fields.

To change the list, open the Work Items panel, click Tooltip Fields, and pick the fields you want. Each field is rendered as a labelled line, using the field’s own label and its formatted value.
A field the work item does not have is skipped. The tooltip only lists fields that exist on the item being hovered, so boards that mix work item types can show shorter tooltips on some cards.
Keep the list short. A tooltip is a hover popup, and a long list of fields is slower to scan than the two or three values that actually drive your planning decision — assignee, status, and estimate for most teams. The Work Items panel also carries a Sidebar Fields parameter, which defaults to Title.

​
Adapt individual cards with an Item Script

Item Script (in Advanced) holds a JavaScript snippet that the board evaluates once for every work item it loads. The script runs on the server, in a read-only transaction, so it cannot change work item data — it can only influence how that one item is treated on the board.
Reach a work item’s fields with Polarion’s getter methods — wi.getType().getId(), wi.getStatus().getId(), wi.getId() — not with property access such as wi.type.id.Property access does not work: the script runs without error and simply has no effect, so a board configured that way looks as though the Item Script were ignored. If a script of yours does nothing at all, this is the first thing to check.
The script receives two objects: Two flags are available: Keep issue work items off a board that is only meant for tasks:
Item Script -- keep issues off the board
Make the whole board read-only, so it can be shared as a plan to look at rather than to change:
Item Script -- read-only board
Hiding an item hides it on this board only. cli.hide removes the card from this board’s view. The work item itself, its dates, and its links are untouched, and it still appears on any other board or report whose query returns it.
The script runs for every item on every load, so keep it short and guard it with a condition on the field you care about rather than doing work for items it should not affect.

​
Config Script

Config Script (also in Advanced) holds a server-side script that the widget evaluates when the page renders, and injects the result into the board’s page. It is a page-level hook, evaluated once per render, in contrast to Item Script, which is evaluated per work item as the board’s data is built. It is empty by default, and a board with an empty Config Script renders normally. Leave it empty unless you have a specific script to run there.

​
Other settings in the Advanced panel

The time-points row is populated from legacy Polarion time points. Leaving Show Time Points selected does not add a row for modern Plans on current Polarion versions. See Swimlanes and Resources.
The default card height of 50 pixels fits a card’s title line and its fields line. Raise it to give the cards more room, or lower it to fit more task rows on screen at once. The full parameter list, panel by panel, is in Widget Parameters.

​
Verification

After changing these parameters, confirm each one on the board itself:
  1. Set Days Forward to a specific number — for example 60 — and save. The footer Timeline range now ends roughly that many days after today, and starts Days Back days before it.
  2. Remove a field from Tooltip Fields and save. Hover a task bar: the tooltip no longer lists that field, and still shows the title and the date range.
  3. Put cli.readonly = true in Item Script and save. Hover a card: the Add Link and Unplan item handles are not offered, and the bar does not move when you drag it.
  4. Replace it with a cli.hide condition that matches one work item type on your board and save. Cards of that type are gone from the timeline, while the work items themselves are unchanged in Polarion.
  5. Clear Item Script and save. The cards and their hover handles come back.

​
See Also

Last modified on August 31, 2026