# Settings

Expand **Settings** to configure settings in the Modern Design interface. Currently, you can configure settings for managing roles across the Pentaho platform.

## Manage roles

Managing roles and permissions is essential for security, compliance, operational efficiency, and a streamlined user experience. The Manage Roles page in the Modern Design interface gives administrators granular control over repository and file access, plugin access, and visibility of content and plugins for each role.

To manage roles, complete the following tasks, in order:

1. [Find permissions](#find-permissions)
2. [Edit permissions](#edit-permissions)
3. [Review and update permission changes](#review-and-update-permission-changes)

### Find permissions

Get started with managing roles by finding the permission or set of permissions that you want to edit for the role.

To find permissions, complete the following steps:

1. Log into the **Pentaho User Console** (PUC).  
2. Navigate to the **Manage Roles** page: 

   * If you are using the **Modern Design**, in the menu on the left side of the page, expand **Settings** and click **Roles**. 
   * If you are using the **Classic Design**, click **Switch to the Modern Design,** and then in the menu on the left side of the page, expand **Settings** and click **Roles**. 

   The **Manage Roles** page opens.
3. Search for or browse to the role you want to manage.
4. To view the permissions that are currently assigned to the role, click **View.** 
5. To edit the role's permissions, click **Edit**. The **Edit permissions** window opens.

   **Note:** Permissions cannot be changed for the Administrator role.
6. Navigate to one of the following sections:
   * **System Permissions**
   * **Plugin Permissions**

**What to do next:** [Edit individual permissions](#edit-individual-permissions) or [multiple permissions at once](#edit-multiple-permissions-at-once). 

### Edit permissions

Edit permissions to control the settings, content, and plugins a user can access and use in the Pentaho platform. Permissions are divided between two main categories, System Permissions and Plugin Permissions. You can edit permissions individually or all at once. For details, see the following sections:

* [Edit System Permissions](#edit-system-permissions)
* [Edit Plugin Permissions](#edit-plugin-permissions)
* [Edit multiple permissions at once](#edit-multiple-permissions-at-once)

#### Edit System Permissions

System permissions control which system settings a user with the assigned role can manage, including security, scheduling, configuration, and data access settings.

To enable or disable individual permissions in the **System Permissions** section, turn permission toggles on and off for each of the following permissions:

<table><thead><tr><th width="234">System Permission</th><th>Description</th></tr></thead><tbody><tr><td>Read Content</td><td>Specifies whether the user can view content in the repository.</td></tr><tr><td>Create Content</td><td>Specifies whether the user can create, import, save, or delete repository content and see the data sources needed for authoring dashboards or reports.</td></tr><tr><td>Execute Schedules</td><td>Specifies whether a user can monitor any schedule and use pause, resume, or run now options, even on schedules they do not own.</td></tr><tr><td>Schedule Content</td><td>Specifies whether a user can add, modify, or delete schedules they own for repository content.</td></tr><tr><td>Administer Security</td><td>Specifies whether to the user is an administrator with full operational permissions. Administrators can access every component, all content, all schedules (including block-out times), and every underlying permission, regardless of checkbox settings.</td></tr><tr><td>Publish Content</td><td>Specifies whether designer tools (Report Designer, Schema Workbench, Metadata Editor, etc.) are unlocked for the user and whether the user can publish or update content and data models in the repository.</td></tr></tbody></table>

#### Edit Plugin Permissions

Plugin permissions control which plugins a user with the assigned role can view in the interface and what they can do while using the plugins they have access to.

{% hint style="info" %}
**Note:** You must have the plugin installed to control its permissions.
{% endhint %}

To enable or disable individual permissions for a plugin, complete the following steps:

1. In the **Plugin Permissions** box, find the plugin permission you want to edit by doing one of the following:
   * Filter the list of displayed permissions by searching for the permission by name.&#x20;
   * Scroll to the plugin with permissions you want to edit and click the chevron icon to expand that plugin section.&#x20;
2. To control whether a plugin is visible for the user role in the Modern Design interface, turn the **Display \<plugin> in User Console** toggle on or off.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Important:</strong> This setting applies only to the Modern Design of PUC. Plugins hidden in Modern Design remain visible in Classic Design.</p></div>
3. To enable or disable permissions for a specific plugin, expand that plugin section and then turn permission toggles on or off for each permission. The permissions available vary between plugins and might include one or more of the following types: **Change**, **Create**, **Delete**, **Edit**, **Execute**, **Import**, **Share**, and **View**.

#### Edit multiple permissions at once

In the Edit permissions window, in the top right corner of each section or plugin, a state-dependent button indicates the state of the permissions for that section or plugin. The System Permissions, Plugin Permissions, and permissions for each plugin section can be in one of the following three states:

* **No Permissions**
* **All Permissions**
* **Permissions vary**&#x20;

To edit multiple permissions at once, you can do one of the following:&#x20;

* Enable all permissions for a section or plugin by clicking the button and selecting **All Permissions**.
* Disable all permissions for a section or plugin by clicking the button and selecting **No Permissions**.

The **Permissions vary** state occurs for sections and plugins with multiple permissions that have a mix of enabled and disabled permissions.&#x20;

### Review and update permission changes

After you finish editing permissions for a role, review your changes and then update the role with the permissions you specified.

To review and update permission changes, complete the following steps:

1. Review the changes in the **Edit permissions** window.

   **Note:** To view only the permissions that were changed, in the **Edit permissions** widow, in the top-right corner, turn on the **Show only what changed** toggle.
2. Click **Update**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentaho.com/pba/pentaho-user-console/modern-design/settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.