title: Managing Portfolios and Applications
Portfolios and Applications are available as part of the Enterprise Edition and above.
Users with the Create Portfolios or Create Applications permission have access to the creation interfaces from the “+” item in the top menu.
Global Administrators have access to the overall Portfolio and Application administration interface at Administration > Configuration > Portfolios. From this page, Portfolios and Applications can be created and edited.
Users of either type can edit an individual Portfolio or Application definition from the lower-level Administration > Edit Definition interface.
Global Administrators also have access to the Projects Management page at Administration > Projects > Management. Changing the selection mechanism on this page to “Portfolios” or “Applications” lets you manage the Portfolios or Applications of your SonarQube instance. The dropdown menu to the right of each item lets you edit permissions, apply Permission Templates or restore access to a Portfolio or Application.
Once your Portfolio exists, you can populate it with any mix of projects, Applications, and sub-portfolios. Applications may only be populated with projects.
To add a sub-portfolio, click on “Add Portfolio” at the top of the third column, and choose:
To add projects directly to a Portfolio or standard sub-Portfolio first make sure the correct item is selected, then choose the Project selection mode:
info
|Project unicity under a portfolio
|Projects, applications and sub-portfolios can only appear once in any given hierarchy in order to avoid magnifying their impacts on aggregated ratings. The portfolio configuration interface has some logic to prevent obvious duplications (e.g. manually adding the same project), however in case of more subtle duplications (e.g. due to regex, or other bulk definition), then the calculation of that portfolio will fail with a helpful error message.
Once your Application exists, you can populate it with manually-selected projects. By default, the configuration interface shows the list of projects currently selected for the application. To add additional projects, choose the “Unselected” or “All” filter.
Once your Application is populated with projects, you can create application branches by choosing long-lived branches from the application’s component projects. This option is available in the Application’s Administration > Edit Definition interface, or from the global administration interface.
Applications and Portfolios are queued to be re-calculated after each analysis of an included project. For each relevant Portfolio and Application, a “Background Task” is created, and you can follow the progress on each in the Administration > Projects > Background Tasks by looking at the logs available for each item.