Cascading Select List
Use Cascading Select List columns to represent hierarchical dropdown options within a table. These behave similarly to Jira’s built-in cascading fields, enabling two-level selections: parent and child.
How it works
When someone selects a value in the parent column while filling out the table, the child column will only show options that were mapped to that specific parent value.
This mapping ensures a clear and dynamic dropdown relationship within your table structure.
Configuration
To create a cascading relationship between two select list columns, follow these steps:
Create the parent column
Add a new select list column to your table.
In the column settings, set maximum selection to '1'.
Create the child column
Add another select list column (this will serve as the child).
Open the column’s Manage dialogue.
Enable the checkbox: Enable cascading select configuration.
Define the parent-child relationship
Once cascading is enabled, two new fields will appear:
Parent select list column – choose the column you created in Step 1.
Only single-select list columns will be available here.
Parent column values – this field appears next to each child option you define. For every new child option you add, select one or more parent values to map it to.
Import cascading select options via CSV
Jira admins can also bulk import select list options—including their cascading parent mappings—directly from a CSV file.
How to use the import feature
Open the Manage column dialog for a child column.
Ensure:
The column uses custom values as a data source.
Cascading select configuration is enabled.
Click the Import icon next to the Parent column values field.
Upload your CSV file.
Only .csv files with a comma as the delimiter are supported.
CSV formatting examples
To add a new option child option (name) with mapping to a value in a parent column (parent)
name | parent |
|---|---|
Option 1 | Category 0, Category 1 |
To update the existing child column option name, together with the parent value
id | name | parent |
|---|---|---|
1 | Option 1 | Category 2 |
To remove the mapped parent value from a specific child column option
id | name | parent |
|---|---|---|
1 | Option 1 |
|
To update the child column option name only (parent will not be changed)
id | name |
|---|---|
1 | Option 1 |
Import behaviour and rules
If a parent value name doesn’t exist → that option will be skipped.
If multiple parent values share a name → the first match will be used.
If the option ID doesn’t exist → skip the row.
If cascading is not enabled, the parent field in CSV will be ignored.
Rows with errors are not imported.