Parent Item Swimlanes

​

Before you begin

• You have a Nextedy PLANNINGBOARD widget already embedded in a Polarion Wiki page or LiveDoc.
• The work items you want to display have parent–child link relationships configured in Polarion (for example, tasks that implement a feature).
• You know the link role that connects child items to their parents (for example, implements, is parent of, or a custom role).

1

Open widget configuration

1. Open the page containing your Planningboard widget.
2. Expand the tools panel and click the edit (pencil) button to enter widget configuration mode.
3. In the configuration panel, navigate to Swimlanes (Rows).

---

2

Set the Assignment Type to Parent Item

In the Assignment Type dropdown, select Parent Item.The Swimlanes (Rows) section expands to show the fields specific to this mode:

Field	Required	Description
Parent Role	Yes	The link role connecting child items to their parent (e.g. implements).
Sort By	No	Field(s) used to order parent swimlanes. See Step 4 below.
Parent Query	No	A Lucene query to restrict which parent items appear as swimlanes.
Filter Parents	No	Yes / No — whether to limit visible parents to those matching the Parent Query.
Report Link	No	A URL to a related report, attached to each parent swimlane for quick navigation.

---

3

Configure Load Parents in the Unplanned Sidebar

For parent swimlanes to display correctly, Planningboard must load the parent work items alongside the child items.

1. In the widget configuration panel, navigate to Unplanned Sidebar.
2. Set Load Parents to at least 1.
3. Set Parent Roles to the same link role you chose in Step 2 (for example, implements).

---

4

Sort parent swimlanes

The Sort By field controls the vertical order in which parent swimlanes appear. It is available since version 25.9.0.Enter one or more Polarion work item field IDs, separated by spaces:

priority

title

severity id

Use the tilde operator (~) to sort in descending order:

~title

priority ~id

Sorting examples:

Sort By value	Result
priority	Swimlanes ordered by priority (ascending)
~priority	Swimlanes ordered by priority (descending)
title	Alphabetical order by title
~title	Reverse alphabetical
priority ~id	By priority ascending; ties broken by ID descending
(empty)	Default order returned by Polarion

---

5

Optionally filter parent items

If you want only a subset of parent items to appear as swimlanes:

1. Enter a Lucene query in Parent Query — for example, type:feature AND status:open.
2. Set Filter Parents to Yes.

Leave both fields empty to show all parent items that have at least one matching child on the board.

---

6

Save and refresh

Click Save in the widget configuration panel. The board reloads and displays one swimlane per parent work item.

---

​

How drag and drop works in this mode

​

Configuration example

# Swimlanes (Rows)
assignmentMode = PARENT
parentRole     = implements
sortBy         = ~priority
parentQuery    = type:feature AND status:open
filterParents  = Yes

​

Limitations

​

Troubleshooting

​

You should now see

​

See also

• Configure Swimlanes (Rows) — full overview of swimlane widget parameters
• Sort Swimlanes — detailed sorting options across all swimlane types
• User and Assignee Swimlanes — grouping rows by assignee instead of parent
• Enumeration Field Swimlanes — grouping rows by a custom enumeration field
• Filter Swimlanes by Plan Range — limit visible swimlanes to the active plan window
• Widget Parameters Overview — full parameter reference