---
title: "Roles & permissions"
description: "Configure roles and permissions in Middleware to control access and secure your monitoring environment."
section: "Settings"
breadcrumb: "Settings > Roles & Permissions Settings"
canonical: "https://docs.middleware.io/features/accounts/roles-permission"
---
# Roles & permissions

Middleware Roles and Permissions defines what users and teams can view or manage in each module. Custom roles let you match access to a team’s responsibilities.

Create custom roles and define permissions for different Middleware modules. Each module can have different access levels, such as View, Create, Edit, or Delete.

Once a role is created, you can assign it to a team.

## View Roles and Permissions

Go to: [Settings → Roles & Permissions](https://app.middleware.io/settings/role)

From here, you can view existing roles and create new roles based on the access your teams require.

### Create a Role

To create a new role:

1. Go to **[Settings → Roles & Permissions](https://app.middleware.io/settings/role)**.
2. Click **[Create New Role](https://app.middleware.io/settings/role?panel=create-update-role)**.
3. Enter the role details.
4. Configure permissions for the required modules.
5. Create the role.

![Create a Role](/images/v3/features/create-a-role.webp)

## Configure Permissions

While creating a role, select which Middleware modules the role should have access to.

For each module, you can configure different permissions depending on the level of access required.

Permissions can include:

- **View** — View data or configurations within the module.
- **Create** — Create new resources or configurations.
- **Edit** — Modify existing resources or configurations.
- **Delete** — Delete resources or configurations.

For example:

Role: Engineering Team

```bash
Permissions
   │
   ├── Module A
   │     ├── View
   │     ├── Create
   │     └── Edit
   │
   └── Module B
         └── View
```

A single role can provide different access levels across modules—for example, editing resources in one module while only viewing another.

## Assign a Role to a Team

After creating a role, you can assign it to a team.

Go to: **[Settings → Teams](https://app.middleware.io/settings/teams)**

Create a new team or select the required team, then assign the role to that team.

Read more about creating a team [here](/features/accounts/users-teams)

Need assistance or want to learn more about Middleware? Get in touch with us via our Contact Us page or join our Slack channel.