Create, edit, copy and delete a role
Click-by-click guide to creating, editing, copying and deleting a role in Settings, including saving, discarding and the unsaved-changes bar.
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.
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
Go to Settings → Roles & Permissions and click Create in the Roles & Permissions section. The Create Role panel opens.
Enter a Role Name (1 to 100 characters).
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.
Pick a Role Color.
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".
Click Create. The role is created and you can open it to fine-tune the permissions.
Create a role from an existing role
Use this when a new role should be "almost like" an existing one.
Open the ⋯ menu of the base role and choose Create from base.
The Create Role panel opens with the base role's permissions already filled in. The description tells you how many permissions are copied.
Enter a name, adjust code and colour, and click Create.
Edit the permissions of a role
Click the role name in the list, or choose Edit in the ⋯ menu. The Permissions tab opens.
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.
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".
If a dialog Activate Required Permissions? appears, the permission needs other permissions first. Click Activate Required Permissions to turn them on too, or cancel.
If a dialog Enable this permission? appears, the permission is critical. Confirm only if you are sure.
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 for the details of switches, levels, dependencies and critical permissions.
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
Open the ⋯ menu of the role and choose Duplicate.
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
Open the ⋯ menu of the role and choose Delete.
Read Delete Role? Everyone with this role loses its permissions and moves to the default role.
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 |
| Dashboard | Default dashboard layout | Set the profile tabs and dashboard for a role |
| eID, Onboarding, Security | eID card, invite email, two-factor requirement | Set eID, onboarding and two-factor for a role |
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. |
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.
Where do I see who has a role?
The User Count column shows how many. In Users, filter or look at the Roles column.