---
title: 'Create, edit, copy and delete a role'
description: >-
  Click-by-click guide to creating, editing, copying and deleting a role in
  Settings, including saving, discarding and the unsaved-changes bar.
icon: wrench
sidebar:
  order: 12
  label: Set up a role
  icon: wrench
---

**Setting up a role means creating it, choosing its permissions and saving it, so that you can then give it to people.** Everything happens in **Settings → Roles & Permissions**. Changes to a role apply to everyone who holds it as soon as you save.

This page walks through creating, editing, copying, making default and deleting a role. To give a role to people, see [Assign roles and access to users](/docs/fuxam-web/settings/assign-roles-to-users).

:::info
You need the **Roles & Permissions** permission to see this page. You can also only save a role if you yourself hold every permission in it. See [Know what you can't set up in a role](/docs/fuxam-web/settings/role-limits).
:::

## The role list

**Settings → Roles & Permissions → Roles & Permissions** lists all roles of your institution. You can search by name. The columns are:

| Column | What it shows |
|---|---|
| **Role Name** | The name. The **Default** badge marks the default role. Click the name to open the role. |
| **Code** | A short unique identifier. You can edit it right in the list. |
| **Role Color** | The colour dot used to recognise the role in user management. |
| **Permissions** | How many permissions the role has. |
| **User Count** | How many people hold the role. |

The **⋯** menu of each row has **Edit**, **Create from base**, **Set Default**, **Duplicate** and **Delete**.

## Create a role

1. Go to **Settings → Roles & Permissions** and click **Create** in the **Roles & Permissions** section. The **Create Role** panel opens.

2. Enter a **Role Name** (1 to 100 characters).

3. Optional: enter a **Role Code**. If you leave it empty, Fuxam generates a unique one. Codes must be unique, so a code that already exists is rejected.

4. Pick a **Role Color**.

5. Under **Start from a template**, choose a starting point: **Student**, **Lecturer**, **Administrator**, **Exam Officer**, **Course Manager**, **Examiner**, **Planner**, **User Management** or **Start from scratch**. The preview shows how many permissions the template adds, for example "12 permissions".

6. Click **Create**. The role is created and you can open it to fine-tune the permissions.

:::note
Every role always includes the permission to see its own tasks. If you start from scratch, the preview says "Only the default own-tasks permission will be added."
:::

## Create a role from an existing role

Use this when a new role should be "almost like" an existing one.

1. Open the **⋯** menu of the base role and choose **Create from base**.

2. The **Create Role** panel opens with the base role's permissions already filled in. The description tells you how many permissions are copied.

3. Enter a name, adjust code and colour, and click **Create**.

## Edit the permissions of a role

1. Click the role name in the list, or choose **Edit** in the **⋯** menu. The **Permissions** tab opens.

2. Use the **Permission areas** navigation to jump to an area, and the **Category** and **Status** filters to show only some permissions or only **Enabled** or **Disabled** ones.

3. Turn permissions on or off. For a permission with levels, choose the level, for example **Read** or **Read & Write**. The switch **All permissions in …** turns a whole area or group on or off, and shows progress such as "3 of 8".

4. If a dialog **Activate Required Permissions?** appears, the permission needs other permissions first. Click **Activate Required Permissions** to turn them on too, or cancel.

5. If a dialog **Enable this permission?** appears, the permission is critical. Confirm only if you are sure.

6. Look at the bar **Unsaved changes** at the bottom. Click **Preview** to check the result, **Discard** (the undo icon) to throw changes away, or **Save**.

The same bar covers all tabs of the role, so you can change permissions, dashboard and security and save once. Read [Understand how permissions work](/docs/fuxam-web/settings/permissions-explained) for the details of switches, levels, dependencies and critical permissions.

:::tip
Click **Preview** before you save. It shows which pages and controls the role would gain or lose. See [Preview what a role can access](/docs/fuxam-web/settings/preview-role-access).
:::

## Rename a role or change its colour

Open the role, click its name in the page header and type the new name, or use the colour picker next to it. Names are 1 to 100 characters. You can change the code in the **Code** column of the list. Edits there are collected in an unsaved-changes bar, so click **Save** afterwards.

The Superadmin role's name, colour and code are locked.

## Duplicate a role

1. Open the **⋯** menu of the role and choose **Duplicate**.

2. Confirm **Copy role "…"?** A new role named "… (Copy)" is created with the same permissions. No people are assigned to it.

Duplicating is the safest way to try changes: edit the copy, check it with the preview, then move people over.

## Set the default role

Choose **Set Default** in the **⋯** menu. Only one role is the default, so the previous default loses the badge. The default role is the fallback for people whose role was deleted or removed. The Superadmin role can't be the default.

## Delete a role

1. Open the **⋯** menu of the role and choose **Delete**.

2. Read **Delete Role?** Everyone with this role loses its permissions and moves to the default role.

3. Confirm **Delete**.

You can't delete the default role, the Superadmin role or the last remaining role.

## What else you can set on a role

| Tab | What you set | Page |
|---|---|---|
| **Profile Information** | Home tabs, profile tabs and auto-requested data | [Set the profile tabs and dashboard for a role](/docs/fuxam-web/settings/role-profile-and-dashboard) |
| **Dashboard** | Default dashboard layout | [Set the profile tabs and dashboard for a role](/docs/fuxam-web/settings/role-profile-and-dashboard) |
| **eID**, **Onboarding**, **Security** | eID card, invite email, two-factor requirement | [Set eID, onboarding and two-factor for a role](/docs/fuxam-web/settings/role-eid-onboarding-security) |

## Common pitfalls

| Pitfall | Why it happens | How to avoid it |
|---|---|---|
| An error when you save | You don't hold every permission in the role yourself. | Ask a Superadmin, or remove the permissions you don't hold. |
| "You cannot edit your own role" | Administrators can't change the role they hold themselves. | Ask another administrator to make the change. |
| "Role changed before the save completed" | Someone else saved the same role while you were editing. | Reload the role, redo your change and save again. |
| A role code error | The code already exists. | Use a different code or leave it empty. |
| Leaving the page loses changes | Changes are saved only with **Save**. | Use **Save** or answer the **Unsaved role changes** dialog with **Stay**, save or discard. |
| A permission is missing | Some permissions only show when a feature or setting is on. | See [Understand how permissions work](/docs/fuxam-web/settings/permissions-explained). |

## FAQ

**Do changes apply immediately?**

Yes, after you click **Save**. Everyone holding the role gets the new permissions the next time their access is checked, which is practically right away.

**Can I undo a deletion?**

No. Create the role again or restore it from a copy. People who lost it stay on the default role until you assign a role again.

**Why can't I edit the Superadmin role?**

Only Superadmins can open it, and its permissions are not editable at all. See [Understand the Superadmin role](/docs/fuxam-web/settings/super-admin-role).

**Where do I see who has a role?**

The **User Count** column shows how many. In **Users**, filter or look at the **Roles** column.

## Related topics

**[Assign roles and access to users](/docs/fuxam-web/settings/assign-roles-to-users)**

Give the role to people.

**[Understand how permissions work](/docs/fuxam-web/settings/permissions-explained)**

Levels, dependencies and critical permissions.

**[Preview what a role can access](/docs/fuxam-web/settings/preview-role-access)**

Check a role before you save it.

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

Limits and locked options.

