docs/user-guide/portfolios/README.md
[feature: portfolio_management ]
Portfolios in OpenProject allow you to organize and manage work at a strategic level by grouping related programs and projects into a single workspace. Information can be gathered about the portfolio in its entirety, allowing to align it to the organization's goals without having to be involved at an operational level.
A portfolio is designed for visibility and coordination rather than execution. It helps stakeholders understand progress, status, and structure across larger initiatives without managing individual tasks or work packages directly.
Portfolios in OpenProject enable you to:
In OpenProject, projects, programs, and portfolios are all workspaces. While they share common properties — such as members, permissions, status, and description — they serve different purposes:
| Topic | Content |
|---|---|
| Portfolios structure in OpenProject | Understand how portfolios, programs, and projects are structured. |
| Hierarchy and composition rules | Learn which workspace types can be combined and how hierarchies are enforced. |
| Example portfolio structures | See common portfolio hierarchy examples. |
| Navigate to portfolios | Learn how to access portfolios in OpenProject. |
| Portfolios overview explained | Understand the portfolios overview page and its elements. |
| Portfolios filters | Filter portfolios by status, membership, or favorites. |
| Portfolio home page | Learn what you can do on a portfolio home page. |
A portfolio is a type of workspace that groups related programs and projects to provide a strategic overview.
A portfolio can contain:
To prevent invalid or unclear workspace structures, there are certain rules for portfolio structuring in OpenProject.
The following examples illustrate common (non-exhaustive) portfolio structures in OpenProject.
Portfolio A
Portfolio X
Portfolio D
Portfolio 123
A portfolio can technically remain empty and function as a standalone workspace. However, in such cases, using a project instead of a portfolio is usually sufficient.
To view the portfolio overview, select Portfolios from the global modules menu on the left, or from the menu behind the grid icon in the header navigation.
To open a specific portfolio, use the All projects dropdown menu in the top left corner and select the portfolio in the same way as you would select a project. Portfolios and programs are visually distinguished by dedicated icons next to their names in the list.
Portfolios can also be accessed from the Project lists overview.
The Portfolios overview page lists all portfolios you have access to and serves as the main entry point for portfolio management.
The page includes the following elements (refer to the annotated screenshot for details):
Each portfolio is displayed in a box containing the following information:
Portfolio name
Portfolio status, which can be edited directly
Portfolio description
Status bar showing the aggregated status of subitems (programs and projects):
Subitems are grouped by status and visualized in the status bar.
Hovering over the status bar displays a detailed status breakdown.
The status bar is shown empty if the portfolio has no subitems or if none of the subitems have a status set.
Favorite indicator (star icon), allowing you to mark or unmark a portfolio as a favorite
Number of programs and projects in the portfolio:
Last updated timestamp
By default, the portfolio overview displays all active portfolios you can access. Use the following filters in the left side menu to refine your view:
A portfolio can be edited, copied, set to public, used as a template, and deleted in the same way as a project. For more information, see the Projects guide.
One difference is that the Subitems widget on a portfolio home page allows you to add both programs and projects as subitems.