---
title: Assign roles and access to users
description: >-
  How to give people roles and access: from the users list, from a person's
  Access tab, and through access templates, plus how to remove them.
icon: users
sidebar:
  order: 13
  label: Assign roles
  icon: users
---

**Assigning a role means giving a person a role, either everywhere in your institution or only on specific records such as one course or cohort.** There are two places to do it: the **Users** table for organisation-wide roles, and the **Access** tab of a person for roles with an access scope.

Before you start, create the role first. See [Create, edit, copy and delete a role](/docs/fuxam-web/settings/set-up-a-role).

## Choose the right way

| You want to… | Use |
|---|---|
| Give one or several roles to a person everywhere | The **Roles** column in the **Users** table |
| Give a role only on certain courses, cohorts, programs and so on | **Add access** in the **Access** tab of the person |
| Give the same role and scope to many people at once | Select people in the **Users** table, then add access |
| Give a fixed bundle of roles and scopes again and again | An [access template](/docs/fuxam-web/settings/access-templates) |

## Give an organisation-wide role

1. Open **Users** and find the person.

2. In the **Roles** column, click the role tags of the person. The role selector opens.

3. Tick the roles the person should have everywhere, and untick those they should lose.

4. Confirm if a dialog appears. A message **Roles updated successfully** shows when it's done.

You can tick several roles. The person receives the sum of all of them. A person must keep at least one role: you'll see "Cannot remove all roles. A user must have at least one role assigned."

### When the person also has roles on specific records

If the person already holds roles on courses, cohorts or study programs, changing their organisation-wide role opens **Change user role to …?** with two choices:

| Button | What happens |
|---|---|
| **Keep Specific Roles** | Only the **The entire organisation** assignment changes. Roles on specific courses, cohorts and study programs stay. |
| **Override All Roles** | All current roles are replaced by the new one. |

If the person has no such roles, you only confirm the simple change, for example **Change role from … to …?**.

### Granting Superadmin

Choosing the Superadmin role opens **Grant this user Superadmin access?** For several people at once, type `super admin` to confirm. See [Understand the Superadmin role](/docs/fuxam-web/settings/super-admin-role).

## Give a role on specific records

1. Open **Users**, open the person and go to the **Access** tab.

2. Click **Add access**. The **Add access** panel opens.

3. Under **What (Role)**, pick one role. The role decides which places are available.

4. Under **Where (Access Scope)**, tick where the role applies, for example **Course**, **Cohort**, **Program**, **Module**, **Curriculum**, **Exam**, **Room**, **Groups of users**, **Individual users**, **Everyone holding a role**, **User fields**, or **The entire organisation**. For each ticked place, choose the specific records.

5. Check **What … can do here**. It lists the abilities that apply in the places you picked, and a separate list **Not used in the selected places** with permissions of the role that don't apply there.

6. When it says **Ready to save**, click **Grant access**. You'll see **Access granted**.

Access is never granted anywhere you didn't list.

:::tip
When you give access to a course, the person also gets access to all courses below it in the course hierarchy.
:::

### The scope groups

| Group | Scopes |
|---|---|
| **Teaching & content** | Course, Cohort, Program, Module, Curriculum, Exam |
| **People & records** | Groups of users, Individual users, Everyone holding a role, User fields |
| **Rooms** | Room |
| **Whole organisation** | The entire organisation |

Scopes marked **Set by role** are available because the role has permissions for that kind of record. Scopes marked **Sensitive** can include grades, personal data or other high-impact records, so double-check them.

:::note
**Everyone holding a role** and **Individual users** are for roles that manage people. For example, a role that may edit users can be limited to the people who hold a certain role. Superadmin can never be assigned this way.
:::

### Why a scope can be unavailable

If a place is greyed out, one of two things applies:

- The role has no permission for that kind of record. Open the role and add one, or pick another role.
- You can't grant it yourself, because you don't hold the permissions. The panel says "You cannot grant: …".

## Give access to many people at once

1. In **Users**, tick the people.

2. Choose the bulk action **Give Access**. The panel says it gives the **Selected users** a role.

3. Choose the role and the places as above and click **Grant access**.

## See where someone's access comes from

The **Access** tab lists every role assignment with the role, where it applies, and an **Origin** column that tells you how the person got it:

| Origin | Meaning |
|---|---|
| **Manual** | Someone assigned it by hand. |
| **Import** | It came from a user import. |
| **Group**, **Cohort**, **Study program**, **Course** | It follows the person's membership there. |
| **Module planning**, **Course management** | It came from planning or management work. |
| **Self-enrollment**, **My courses**, **Module catalog**, **Course waitlist** | It came from the person enrolling or being admitted. |
| **Company contact** | It came from being a company contact. |
| **Access scope · name** | It came from an [access template](/docs/fuxam-web/settings/access-templates). |

## Remove access

In the **Access** tab, remove the row with **Remove Access**. The role on that record is gone, other roles stay. If the row came from an access template, remove it from the template instead, or unassign the template.

## Common pitfalls

| Pitfall | Why it happens | How to avoid it |
|---|---|---|
| The person lost course roles | **Override All Roles** was chosen. | Pick **Keep Specific Roles** unless you want a clean slate. |
| A role "doesn't work" on a course | A permission is course-based and the role was given organisation-wide. | Add the role on that course in the **Access** tab. See [Understand how permissions work](/docs/fuxam-web/settings/permissions-explained). |
| "Already assigned" in the panel | The role is already this person's organisation-wide role. | Choose other places, or a different role. |
| Access removed, but it comes back | An access template, group or import grants it again. | Check the **Origin** column and fix the source. |

## FAQ

**Can one person have several roles?**

Yes. Organisation-wide roles in the **Users** table and roles on specific records add up. A person always keeps at least one role.

**What is the difference between a role and an access scope?**

The role says what is possible. The access scope says where it is granted. See [Understand roles, scopes and permissions](/docs/fuxam-web/settings/what-is-a-role).

**Can I see what a person can access?**

Yes. Open the person's **Access** tab. It lists every role they hold and where it comes from. The role **Preview** shows what a role reaches, see [Preview what a role can access](/docs/fuxam-web/settings/preview-role-access).

## Related topics

**[Bundle roles into access templates](/docs/fuxam-web/settings/access-templates)**

Reuse the same roles and scopes for many people.

**[Create, edit, copy and delete a role](/docs/fuxam-web/settings/set-up-a-role)**

Build the role first.

**[Know what you can't set up in a role](/docs/fuxam-web/settings/role-limits)**

What you can and can't grant.

**[Manage users](/docs/fuxam-web/base/user-management)**

The wider guide to the Users area.

