Enterprise organizations running dozens or hundreds of projects often manage their software projects as a hierarchical relationship. A hierarchy that exists only on paper is a hierarchy nobody can navigate, govern, or trust. This release gives that structure a visual, navigable interface.
SonarQube Cloud now provides a dedicated portfolio hierarchy management in a UI that lets enterprise admins, divisional directors, and CISOs see parent-child portfolio relationships at a glance, understand exactly where they stand within a deep structure, and build or modify that structure with guardrails that prevent invalid changes before they happen.
Who can use SonarQube Cloud portfolio hierarchy management?
This release is built for enterprise teams managing multi-level portfolio structures across many projects and teams from a single interface. It is currently available to everyone with a SonarQube Cloud Enterprise plan.
What's new in SonarQube Cloud enterprise portfolio management?
Visual hierarchy at unlimited depth
Organizational structures do not stop at two or three levels, so the hierarchy view does not either. The portfolio hierarchy management UI renders a full tree view of parent-child portfolio relationships, supporting unlimited nesting depth in this first version. Each level uses iconography and labeling to make the list easy to follow, no matter how many levels it has.
Breadcrumb signposting at every level
Losing track of your position inside a deep hierarchy is not a cosmetic inconvenience, it is a governance risk: a change made at the wrong level can misattribute metrics or break reporting for an entire division. A breadcrumb trail shows your current position in the structure at every level you navigate, so you always know exactly where a given portfolio sits relative to the rest of the organization before you act on it.
Circular reference protection with plain-language messages
A circular reference, a loop or self-link in the hierarchy, is not just an error state, it is a structural problem that can silently corrupt reporting if it goes undetected. SonarQube Cloud now prevents circular relationships in portfolio hierarchies, for example placing a parent portfolio under one of its own children. It blocks the change before saving and displays a plain-language message explaining why the relationship is not allowed.
Guided link and unlink flows with confirmation
Restructuring a portfolio hierarchy has real consequences for reporting and compliance, so making that change should never be a single accidental click. Linking a child portfolio to a parent, or unlinking one from the hierarchy, now runs through a guided flow with an explicit confirmation step before the change commits, giving admins a clear understanding of the consequences before they act.
Clear level distinction at any depth
Telling parent from child at a glance matters more as a hierarchy grows, not less. Each level in the tree is visually distinguished through indentation, iconography, and labeling. Therefore, the relationship between any two portfolios is clear, without requiring a user to manually trace the structure.
Performance built for scale
SonarQube Cloud’s portfolio hierarchy view lets users expand and collapse branches to explore nested portfolios, revealing child portfolios as branches are expanded, rather than displaying every level at once.
Keyboard accessibility
The hierarchy tree is fully keyboard-navigable, with appropriate ARIA roles applied to parent-child relationships, so the interface is usable for admins who rely on keyboard navigation rather than a mouse.
How do I get started with portfolio hierarchy management in SonarQube Cloud?
The portfolio hierarchy management feature is available now to eligible SonarQube Cloud Enterprise customers. A new portfolio hierarchy guide walks through building, navigating, and managing a hierarchy end to end, and the Enterprise admin documentation has been updated to reflect the new interface and workflows.
Organizing structure is the first step. Governing it at scale is the reason that structure needs to be visible in the first place.
