Dimensions are the building blocks of board configuration. Learn how to add, configure, reorder, and move dimensions between sections.
Find the controls
Expand Board Structure in the sidebar, then Columns, Rows or Grouping. The section’s + adds a dimension. Controls beside each field act on that dimension, not the entire board.
Drag, ordering, coverage, timeline, direction, header side and removal stay beside each field.
Use the field selector to change the dimension, its handle to move it, and delete to remove it. Columns and Rows also offer direction and header-position controls. Grouping has its own expand/collapse controls, shown in the Grouping guide.
About dimensions
A dimension is a Jira field used to organise cards on your board. Dimensions can be added to three sections:
- Columns: creates vertical bands
- Rows: creates horizontal bands
- Grouping: creates collapsible card clusters
Try one field first: on a loaded board, expand Board Structure → Columns, select Add dimension and choose Status. Look for status headings and cards placed in their matching columns. You can stop there, or add Priority Rows next.
Use the Columns + button, then choose the System field Status.
Add dimension is the + beside the section name. In the selector, choose Status under System fields, not Status category. Here, a dimension means the field you have just selected. This changes the view, not Jira’s field values.
Status in Columns places work beneath its workflow heading.
The enlarged result shows part of the Status board. Cards beneath In Progress have that status. Start with this one useful dimension before trying the advanced combinations below.
Unlimited nesting
Board Studio places no limit on the number of dimensions you can add to any section. You can freely combine:
- Multiple column dimensions (nested columns)
- Multiple row dimensions (nested rows)
- Multiple grouping dimensions (nested groups)
- Any combination across all three sections
This flexibility allows you to create deeply hierarchical board layouts that match your team’s planning needs, from simple single-dimension views to complex multi-level matrices.
Example: Combine Sprint and Team in Columns, Status and Priority in Rows, and Epic and Component in Grouping for a cross-team programme view.
Add a dimension
- In the sidebar, expand Board Structure
- Expand the section where you want to add the dimension
- Select Add dimension
- Choose a Jira field from the dropdown
The board updates immediately to reflect the new organisation.
Available fields
The dropdown shows all fields available in your current data source, organised into:
- System fields: Status, Priority, Assignee, Sprint, Work Item Type, and other standard Jira fields
- Custom fields: Team, Epic Link, Story Points, and custom fields configured in your spaces
Dimension controls
Controls depend on the section. Columns and Rows have direction and header-position controls; Grouping instead has an expand/collapse chevron.
| Control | Description |
|---|---|
| Drag handle | Grab to reorder or move to another section |
| Field selector | Change the Jira field for this dimension |
| Sort direction | For Columns and Rows, toggle between ascending and descending order |
| Start position | For Columns and Rows, choose the side displaying the headers |
| Delete | Remove the dimension from the section |
Sort direction
Controls how values are ordered:
| Direction | Behaviour |
|---|---|
| Ascending (↑) | A→Z, lowest→highest, oldest→newest |
| Descending (↓) | Z→A, highest→lowest, newest→oldest |
Fields can have their own ordering: Status follows workflow order and Priority follows Jira rank, not alphabetical order. For Columns and Rows, select the sort icon to reverse that sequence. Grouping has a separate expand/collapse chevron; see Grouping.
Start position
Controls which side of the board displays the dimension’s headers:
| Section | Options |
|---|---|
| Columns | Top or Bottom |
| Rows | Left or Right |
Reorder dimensions
When a section has multiple dimensions, the first field creates the outer divisions; subsequent fields subdivide them. This nesting is separate from the Grouping section and from Jira’s parent-child hierarchy.
Suppose you want to review work by Jira priority across statuses, rather than review each status separately. For this example, leave Columns empty and place Status, then Priority, in Rows. Each status contains its own priority bands.
Status creates the outer rows; Priority subdivides each status.
To make priority the outer division:
- Grab Priority by the dotted drag handle to the left of its field name.
- Drag it above Status within Rows. Keep the pointer over the destination row if the sidebar shifts as drop areas appear.
- Release, then check that Rows lists Priority, followed by Status.
Priority now creates the outer rows; Status subdivides each priority.
The outer bands are now Highest, High and Medium in this example. Each priority contains its own status rows, so you can review high-priority work across workflow stages. The same fields and cards remain; their nesting changes. This does not change Jira priorities or statuses, and it does not save a named board.
Drag Status back above Priority to return to the original nesting. Moving a field to a different section is a separate action, shown next.
Move dimensions between sections
You can move a dimension from one section to another using drag and drop:
- Grab the dimension by its drag handle
- Drag it into the expanded destination section’s list area (for example, from Rows to Grouping)
- Release to complete the move
The dimension:
- Retains its field selection
- Now applies the behaviour of the new section type
Tip: Moving a dimension between sections is useful when experimenting with different board layouts. Try a field as a swimlane, then drag it to grouping to compare the results.
Recognise a completed move
Suppose you started with Status Columns and Priority Rows but would rather read workflow stages down the page. Drag Status by its handle from Columns into Rows, before Priority. Columns is now empty, and Rows lists Status, then Priority.
Status now divides the rows, with Priority nested inside each status.
Each status now contains its own priority bands. The cards keep their Jira Status and Priority values; only the way the board organises them changes. Compare the field lists as well as the canvas to check that you moved the dimension rather than adding a second copy.
Remove a dimension
- Hover over the dimension row
- Select the delete button
- The dimension is removed and the board updates
Multi-level hierarchies
Add multiple dimensions to create nested organisation. For example, with two Column dimensions, Sprint creates the primary columns and Team subdivides each column. These nested field dimensions organise the view; they are separate from Jira’s parent-child issue hierarchy and the toolbar’s semantic levels.





