# Administering portfolios

This feature is only available in the [Enterprise plan](https://www.sonarsource.com/plans-and-pricing/#sonarqube-cloud-features).

A portfolio is a set of projects within an enterprise that enables an aggregate view of its state through various lenses, including releasability, security, reliability, and maintainability.

{% hint style="info" %}
Before you can view the Enterprise-level reports, your organization must be added to an enterprise. For more information, see [managing-enterprise](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise "mention").
{% endhint %}

## Permissions <a href="#permissions" id="permissions"></a>

* To create a portfolio or a portfolio permission template, you must first be granted the Create Portfolios permission by Enterprise Administrator. See [#set-permissions](https://docs.sonarsource.com/sonarqube-cloud/setting-up-your-enterprise#set-permissions "mention") for details.
* The permissions to administer, edit, or view a portfolio are granted by the portfolio administrator in the portfolio settings.

### Administer, edit, and view permissions <a href="#administer-edit-and-view-permissions" id="administer-edit-and-view-permissions"></a>

As an administrator of a portfolio, you can assign users and groups permission to **Administer**, **Edit**, and **View** portfolios to selected users and groups.

* **View**: Users can view the portfolio’s **Overview**, **Portfolio** **Breakdown**, and **Measures** tabs. On the **Portfolio** **Breakdown** page, users can only view the projects they have access to (Browse permission).
* **Edit**: Users can change the portfolio definition (add or remove projects) and delete a portfolio. However, they can only add or remove projects they have access to (Browse permission).
* **Administer**: Users can change the portfolio’s permissions.

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2FXglIsbw8WC92NMrB7I9z%2Fportfolio-permissions.png?alt=media&#x26;token=c337ee07-f1db-4d5f-bb35-a7863111b31f" alt="Portfolio permissions page"><figcaption></figcaption></figure></div>

1. Go to **My Portfolios** in the top navigation and select your enterprise from the drop-down menu.
2. Select the portfolio you want to add the permissions to from the Portfolios home page
3. Go to **Administration** > **Permissions**
4. Assign users and groups the **Administer**, **Edit**, and **View** permissions or select **Apply Permission Template**. The Filters sidebar allows you to find users by **Type**, **Role**, and **Organization**.

## Portfolio permission templates <a href="#permission-templates" id="permission-templates"></a>

Portfolio permission template defines the portfolio-related permissions granted to groups and members of your enterprise. Enterprise administrators can define several permission templates in your organization including a default template. Using permission templates allows you to:

* Grant or revoke different sets of permissions to users or groups.
* Set a default template for new portfolios.

### Creating portfolio permission templates <a href="#creating-permission-templates" id="creating-permission-templates"></a>

The Enterprise administrator permission is required to create permission templates:

1. Retrieve your enterprise. See [retrieving-and-viewing-your-enterprise](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise "mention").
2. Select **Administration** > **Portfolio Permission Templates**.
3. Select **Create new template** at the top right of the page.
4. Enter the **Template Name** and **Description** in the modal.
5. Assign users and groups the **Administer**, **Edit,** and **View** permissions. The Filters sidebar allows you to find users by **Type**, **Role**, and **Organization**.

### Editing portfolio permission templates <a href="#editing-permission-templates" id="editing-permission-templates"></a>

To edit an existing permission template:

1. Retrieve your enterprise. See [retrieving-and-viewing-your-enterprise](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise "mention").
2. Select **Administration** > **Portfolio Permission Templates**.
3. From your permission template’s **Actions** menu you can set the template as default for new portfolios, edit permissions, update name and description or delete the template.

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2F2VzPnuf8dx6OvC8sqIlU%2Fportfolio-permission-template.png?alt=media&#x26;token=d6aa83f7-8ea6-4ce4-bb1b-b2dfd3e6ae14" alt="Options for the portfolio permission template"><figcaption></figcaption></figure></div>

{% hint style="info" %}
If you update a portfolio permission template, the changes are not reflected in any previously created or updated portfolios using that template.
{% endhint %}

## Related pages <a href="#related-pages" id="related-pages"></a>

* [](https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise "mention")
* [viewing-portfolios](https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise/viewing-enterprise-reports/viewing-portfolios "mention")
* [managing-portfolios](https://docs.sonarsource.com/sonarqube-cloud/managing-portfolios "mention")