---
description: Manage access and permissions for users within the space
---

# Roles

Use Roles to assign specific permissions to users invited to your space. Create a new custom role for each user or use one of our predefined roles. You can use the predefined roles as a template that you can copy to modify just a part of the permissions to fit the needs of your team and workspace.

You can find role settings and specific permissions:

1. Under "Users and Roles" in the left sidebar menu

<figure><img src="https://1428908423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kePaAlhzmPFZTjuxdCY%2Fuploads%2FzBoJPFWeVdkOp7ebZ6Lu%2Frolesfrommenu.gif?alt=media&#x26;token=b75e6e89-a454-4000-afdc-590610deff3c" alt=""><figcaption><p><mark style="color:purple;">Access Roles from the side menu</mark></p></figcaption></figure>

2. In the Space settings

<figure><img src="https://1428908423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kePaAlhzmPFZTjuxdCY%2Fuploads%2F4bcz0QgP8tLTPp4jRgIa%2Frolesfromspacesettings.gif?alt=media&#x26;token=c1cf45df-7f45-4b7b-b5f7-ede617ee1d2e" alt=""><figcaption><p><mark style="color:purple;">Access Roles from Space setttings</mark></p></figcaption></figure>

By assigning a role, you determine how individual users can interact with the space, its rules and settings. Use our predefined roles for simple permissions or create roles of your own. To assign a role to a user click on the role dropdown list next to the user’s name.

<figure><img src="https://1428908423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kePaAlhzmPFZTjuxdCY%2Fuploads%2Ff4RngcXsILzcjhimNS86%2Fassignrole.png?alt=media&#x26;token=e1f65ad8-725e-48b9-b5c0-325a2f910bdc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
_You can not change the role of the space owner_
{% endhint %}

## Predefined roles

A user with the <mark style="color:purple;">Admin</mark> role is allowed to perform all activities in the space and has access to all rules and features. The <mark style="color:purple;">Editor</mark> has the same rights as the Admin except for setting up the space, managing users, and deleting API Keys. <mark style="color:purple;">Reader</mark> is allowed to just view the data and settings in each feature.

## Creating a new role

As mentioned, you can create new user roles for your project. You can create them in two ways

One way is by copying one of our predefined roles, where you can modify part of the permissions. In the example below, a new role similar to the Editor will be created, but the user will only be able to work with decision table rules.\


<figure><img src="https://1428908423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kePaAlhzmPFZTjuxdCY%2Fuploads%2FefEylsWqPCog7OsbJK3q%2Fcopyfromeditorrole%20(1).gif?alt=media&#x26;token=9010b0d7-9709-43db-a548-00eda270749a" alt=""><figcaption></figcaption></figure>

The other way is to create a completely new role where you customize the permissions as needed. For example, you can create a new role where the user is only allowed to work with Decision Trees, plus they can change the space settings.

<figure><img src="https://1428908423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kePaAlhzmPFZTjuxdCY%2Fuploads%2FjH8WWENyXGmLEJRSL6dn%2Fnewrole.gif?alt=media&#x26;token=264610eb-8120-4cb5-94a4-2533ad5caeea" alt=""><figcaption><p><mark style="color:purple;">Creating a new role</mark></p></figcaption></figure>

If you no longer need them, you can delete any roles except the predefined ones. Click the ![](https://1428908423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kePaAlhzmPFZTjuxdCY%2Fuploads%2FK4U1LhmdrwesIF3F3Rw8%2Fdeleterolebtn.png?alt=media\&token=09febe99-f663-4101-8138-2f50a86988a5) button next to the selected role and confirm to delete the role.
