> ## 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. # Enumeration Field Mode > Enumeration Field mode groups work items into swimlanes based on the values of a Polarion enumeration custom field. This page is a reference for the parameters, supported field types, filtering options, and known limitations of the Enumeration Field assignment mode. For an overview of all available swimlane assignment types, see [Assignment Modes](/planningboard/reference/assignment-modes/index). *** ## How It Works When `assignmentMode` is set to `ENUM`, Nextedy PLANNINGBOARD reads the configured enumeration field on each work item and places the card in the swimlane that corresponds to that field's value. Work items whose field is empty or whose value is not included in the rows filter are placed in the **Not Assigned / Other** swimlane at the bottom of the board. When a work item has a **multi-value** enumeration field (list type), the card can appear in multiple swimlanes simultaneously — one per value held by that field. Board layout in Enumeration Field mode: swimlane rows for Team Alpha, Team Beta, Team Gamma, and Not Assigned / Other, each with cards distributed across Plan A, Plan B, and Plan C columns *** ## Widget Parameters Configure Enumeration Field mode in the **Swimlanes (Rows)** section of the Widget Parameters panel. ### Core Parameters | Name | Type | Default | Description | | ---------------- | ------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `assignmentMode` | string | `ASSIGNEE` | Set to `ENUM` to enable Enumeration Field mode. | | `enumFieldId` | string | — | **Required.** The field ID of the Polarion enumeration custom field to use for swimlane grouping. Example: `team`, `component`, `severity`. Must match the exact field ID as configured in Polarion. | ### Row Visibility | Name | Type | Default | Description | | -------------------- | ------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | `showEmptySwimlanes` | boolean | `false` | When `true`, swimlanes with no work items are shown. When `false` (default), only swimlanes that contain at least one card are rendered. | | `swimlaneSort` | string | `alphabetical` | Sort order for swimlane rows. Applies to Enumeration Field mode. | ### Row Filtering | Name | Type | Default | Description | | ------------ | -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `rowsFilter` | multi-value selector | (all values) | Limits which enumeration values appear as swimlane rows. When no values are selected, all values from the field's enumeration are shown. When one or more values are selected, only those values appear as rows. Configured via the **Rows Filter** dialog in the Widget Parameters panel. | ### Optional | Name | Type | Default | Description | | ------------ | ------ | ------- | ------------------------------------------------------------------------------------------------------------------- | | `reportLink` | string | — | Optionally attach a Polarion report URL. The link is surfaced per swimlane for deeper analysis of that field value. | *** ## Supported Field Types Planningboard supports the following Polarion field types for Enumeration Field mode: | Field Type | Supported | Notes | | --------------------------------------------------- | --------- | ----------------------------------------------------------------------------- | | Single-value enumeration (`IEnumType`) | Yes | Each card appears in exactly one swimlane. | | Multi-value enumeration (list of `IEnumType` items) | Yes | A card with multiple values appears in each matching swimlane simultaneously. | | `status` field | **No** | Not supported as a swimlane grouping field. | | `resolution` field | **No** | Not supported as a swimlane grouping field. | | `type` (work item type) field | **No** | Not supported as a swimlane grouping field. | | Free-text or numeric fields | **No** | Only enumeration-typed fields are valid. | Global enumeration custom fields (defined at the global Polarion administration level rather than per project) are not reliably supported for swimlane grouping. A global field may appear to validate correctly during initial widget configuration but fail post-save with the error **"field does not exist or is not of type enumeration"**. **Workaround:** Use project-specific enumeration custom fields. If you require a global enum field, contact Nextedy support. Full support for multi-value (multi-select) enumeration fields as swimlane sources was under active development as of early 2026. If you encounter issues with multi-enum swimlanes, verify you are running a current release and contact support. *** ## Rows Filter The **Rows Filter** lets you restrict which enumeration values are displayed as swimlane rows, without modifying the field definition in Polarion. **Behaviour:** * An **empty filter** (no values selected) shows all values from the enumeration — every option defined on the field for the current work item type appears as a swimlane row. * A **populated filter** shows only the selected values. Values not in the filter are hidden; work items whose field holds a hidden value are placed in the **Not Assigned / Other** swimlane. * Available enum values in the Rows Filter dialog reflect the **selected work item type** on the board. Different work item types may define different option sets for the same field ID. **How to configure:** 1. Open the Widget Parameters panel and navigate to **Swimlanes (Rows)**. 2. Set **Assignment Type** to **Enumeration Field**. 3. Enter the **Field ID** of your enumeration field. 4. Click the **Rows Filter** selector to open the multi-value dialog. 5. Select the values you want to appear as rows and confirm. Rows Filter dialog for the team field, with Team Alpha and Team Beta checked, Team Gamma and Team Delta unchecked, and Cancel/Confirm buttons *** ## Configuration Example The following example configures a Planningboard to display swimlanes grouped by a project-level `team` enumeration field, showing only two specific teams and hiding empty rows. **Widget Parameters — Swimlanes (Rows) section:** ```properties theme={null} assignmentMode=ENUM enumFieldId=team showEmptySwimlanes=false swimlaneSort=alphabetical ``` **Rows Filter selection:** `Team Alpha`, `Team Beta` In this configuration: * Work items with `team=Team Alpha` appear in the **Team Alpha** swimlane. * Work items with `team=Team Beta` appear in the **Team Beta** swimlane. * Work items with any other team value, or no team value, appear in **Not Assigned / Other**. * Empty swimlanes are hidden — if no items are planned for a team in the visible Plans, that row does not render. *** ## Drag-and-Drop Assignment When a user drags a card from one swimlane to another in Enumeration Field mode, Planningboard updates the enumeration field on the work item to the value corresponding to the target swimlane. This write-back happens immediately on drop. **Restrictions:** * Dragging a card to the **Not Assigned / Other** swimlane clears the field value on the work item (sets it to empty). * In read-only mode, drag-and-drop is disabled and field values cannot be changed from the board. * In prioritize mode, drag-and-drop is also blocked. When using a multi-value enumeration field, dragging a card between swimlanes appends or removes individual values rather than replacing the entire field. Verify the resulting field state in Polarion after moving items with multiple values. *** ## Swimlane Sort Order The `swimlaneSort` parameter controls the vertical order of swimlane rows when using Enumeration Field mode. | Value | Behaviour | | ------------------------ | --------------------------------------------------------------------------- | | `alphabetical` (default) | Swimlane rows are sorted A–Z by the display label of the enumeration value. | Additional sort options (e.g., by enumeration option order as defined in Polarion, or custom ordering) may be available. Verify against the running application for the current option set. *** ## Capacity in Enumeration Field Mode Capacity bars and capacity load work with Enumeration Field mode in the same way as other assignment modes. Each swimlane row shows a capacity bar reflecting the total effort of cards assigned to that row across the visible Plans. When a work item appears in multiple swimlanes (multi-value field), its effort is counted in each swimlane it appears in. This can result in effort being counted more than once across the board total. See [Capacity Parameters](/planningboard/reference/widget-parameters/capacity-parameters) for capacity configuration details. *** ## Limitations | Limitation | Details | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | Global enumeration custom fields | Not reliably supported. Use project-specific fields. See the warning above. | | `status`, `resolution`, and `type` fields | Cannot be used as the swimlane grouping field. | | Multi-enum swimlane support | Was under active development as of early 2026; verify support in your installed version. | | Capacity double-counting | When a multi-value field places a card in multiple swimlanes, effort is counted per swimlane — not de-duplicated at board level. | | Swimlane sort is coupled to item sort | The vertical order of swimlanes and the order of items within swimlanes share the same underlying sort mechanism; configuring one affects the other. | | Custom-enum card coloring | Card coloring based on enumeration values may have parity gaps compared to other Nextedy board products. | *** ## Troubleshooting ### "Field does not exist or is not of type enumeration" after saving **Cause:** The configured `enumFieldId` either does not exist in the project, is not an enumeration type, or is a global field that is not supported in this context. **Steps:** 1. Verify the field ID is spelled exactly as defined in Polarion Administration → Custom Fields for the relevant work item type. 2. Confirm the field type is **Enumeration** (single or multi-value list), not text or numeric. 3. If using a global field, switch to a project-level enumeration field instead. 4. After correcting the field ID, save the widget configuration. If the error persists, rebuild the widget configuration: remove the swimlane configuration, save, re-add it with the correct field ID, and save again. ### Rows Filter shows no options **Cause:** The enumeration field has no values defined for the currently selected work item type, or the field ID is incorrect. **Steps:** 1. Confirm the **Field ID** is correct and the field is associated with the work item type shown on the board. 2. Check that the enumeration has at least one option defined in Polarion Administration for that work item type. 3. Change the work item type selector on the board to the type that has the field configured, then re-open the Rows Filter dialog. ### Cards appear in "Not Assigned / Other" unexpectedly **Cause:** The field value on the work item is empty, or the value is excluded by the Rows Filter. **Steps:** 1. Open the work item in Polarion and confirm the enumeration field has a value set. 2. Check the Rows Filter in the widget configuration — if specific values are selected, items with other values are routed to Not Assigned / Other. 3. Clear the Rows Filter (deselect all values) to show all enum values as rows, and verify where items land. *** ## Related Pages * [Assignment Modes](/planningboard/reference/assignment-modes/index) — overview of all swimlane assignment types * [Assignee Mode](/planningboard/reference/assignment-modes/assignee-mode) — swimlanes by user/assignee * [Parent Item Mode](/planningboard/reference/assignment-modes/parent-mode) — swimlanes by parent work item * [Project Mode](/planningboard/reference/assignment-modes/project-mode) — swimlanes by sub-project * [Swimlanes (Rows) Parameters](/planningboard/reference/widget-parameters/swimlanes-parameters) — full swimlane widget parameter reference * [Capacity Parameters](/planningboard/reference/widget-parameters/capacity-parameters) — capacity bar configuration **KB Articles** * Swimlane Assignment Types * Filter user swimlanes by Plan range * What is 'Normalization' **Support Tickets** * [#6777](https://support.nextedy.com/helpdesk/tickets/6777) * [#5879](https://support.nextedy.com/helpdesk/tickets/5879) * [#6734](https://support.nextedy.com/helpdesk/tickets/6734) **Source Code** * `PlanningBoardWidgetRenderer.java` * `PlansMode.java` * `PlanningBoardDataService.java` * `PlanningBoardWidgetDependenciesProcessor.java` * `planningboard.js`