---
title: Bundle roles into access templates
description: >-
  How access templates bundle roles so you can assign the same access to many
  people at once, including creating, editing and removing templates.
icon: package
sidebar:
  order: 14
  label: Access templates
  icon: package
---

**An access template is a reusable bundle of roles, each tied to a place such as a course or a cohort, that you can give to many people in one step.** When you change the template later, everyone who has it gets the change too.

Use a template when you give the same combination again and again, for example "Course coordinator": the Lecturer role on one course plus the Course Manager role on one cohort.

:::note
In some dialogs and messages the UI calls a template an **access scope**, for example **Access Scopes**, **Assign access scope** or **Delete access scope**. They are the same thing. The page that lists them is titled **Access Templates**.
:::

## Where to find access templates

Go to **Settings → Roles & Permissions** and scroll to the **Access Templates** section ("Reusable access setups that you can apply to users"). It is a table with the columns **Name**, **Description**, **Roles**, **Users** and a ⋯ menu. Click a name to open the template.

You need the **Roles & Permissions** permission (area **Organization & Access Rights**) to create, edit or delete templates. To give a template to someone you also need the permission to change that person's access and to edit users. See [Settings permissions](/docs/fuxam-web/settings/permissions-settings-pages).

## Create an access template

1. Go to **Settings → Roles & Permissions** and find **Access Templates**.

2. Click **Create access template**. The sheet **Create Access Template** opens.

3. Enter a **Name** (up to 120 characters), for example "Course Coordinator". Optionally add a **Description** (up to 2000 characters) and pick a **Color**.

4. Confirm. The template opens and you see **Access scope created**. It has no roles yet, so it grants nothing until you add some.

## Add roles to a template

Each row of a template is one role tied to one place. A template can have as many rows as you need.

1. Open the template and stay on the **Roles** tab.

2. Click **Add role**.

3. Choose a **role**, then choose where it applies, for example **Course**, **Cohort**, **Study program**, **Module**, **Room**, **Curriculum**, **Exam** or **The entire organisation**, and pick the concrete record. This works exactly like the sheet in [Assign roles and access to users](/docs/fuxam-web/settings/assign-roles-to-users).

4. Save. You see **Roles added**. The new role is granted to everyone who already has the template.

Click a row to see what it grants and where it applies. **Open role settings** takes you to the role itself.

:::warning
The Superadmin role can't be put into a template. See [Know what you can't set up in a role](/docs/fuxam-web/settings/role-limits).
:::

### Edit or remove a role row

Open the row's menu and choose **Edit role** to change the role, the scope or the target, then **Save changes**. Choose **Remove role** to take the row out. The dialog **Remove this role?** tells you how many people have the template, because removing the row revokes the role for all of them.

If a row says **Target entity no longer exists**, the course, cohort or other record it pointed to was deleted. Edit the row to point to a new one, or remove it.

## Give a template to people

You can do it from either side.

**From the template:**

1. Open the template and go to the **Users** tab (**Connected Users**).

2. Click **Add users** and select the people.

3. Confirm. Everyone selected receives every role in the template. People who already have it are skipped and nothing changes for them.

**From the person:**

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

2. In the section **Access Scopes**, click **Assign access scope** and choose a template. The preview shows the roles the person will receive.

3. Confirm. If you have no templates yet, the button is disabled and tells you to create one first.

In the person's **Access** tab, the roles that came from a template show **Access scope · template name** in the **Origin** column.

## Check who has a template

The **Users** tab lists each person with their **Email**, **Assigned by** and a status:

| Status | Meaning |
|---|---|
| **In sync** | The person's roles still match the template. |
| **Modified** | Someone changed the person's roles by hand. Hover over **Modified** to see what: a role was removed or a role was changed. |

If the person who assigned the template was removed from the system, **Assigned by** says the assigning user was removed.

## Take a template away from someone

On the **Users** tab, open the ⋯ menu of the person and choose **Remove connection**, or on the person's **Access** tab choose **Unassign** next to the template. The dialog **Remove this user from the access scope?** or **Unassign access scope?** explains that every role and permission the template granted is removed. You can assign it again later.

## Edit or delete a template

In the ⋯ menu of the list or the template header, choose **Edit** to change the name, description or colour. Choose **Delete access scope** to delete it. The dialog **Delete this access scope?** shows how many people currently have it. Deleting removes the permissions it granted for all of them.

## Common pitfalls

| Pitfall | Why it happens | How to avoid it |
|---|---|---|
| A template grants nothing | It has no rows yet. | Add at least one role on the **Roles** tab. |
| A change reached more people than expected | Changes to rows apply to everyone with the template immediately. | Check the user count in the list before you edit. |
| The person still has the access after you removed a row | The same role was also given manually or by a group or import. | Check the **Origin** column on the person's **Access** tab. |
| The status shows **Modified** | Someone edited that person's roles directly. | Hover over the badge, then fix the person or accept the difference. |

## FAQ

**Is an access template the same as a package in my subscription?**

No. An access template has nothing to do with the product packages you buy. It is only a bundle of roles and places that you build yourself.

**Do changes to a template reach people who already have it?**

Yes, immediately. Adding, editing or removing a row changes the access of everyone who has the template.

**Can I use the same template for hundreds of people?**

Yes. That is what it is for. Select the people with **Add users** on the **Users** tab.

**What is the difference between a template and a role?**

A role says what is allowed. A template says which roles go to which places, so it is a role plus a scope, repeated for as many rows as you need. See [Understand roles, scopes and permissions](/docs/fuxam-web/settings/what-is-a-role).

## Related topics

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

Give one role to one or many people without a template.

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

Build the roles you put into templates.

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

What a template can and can't contain.

**[Understand roles, scopes and permissions](/docs/fuxam-web/settings/what-is-a-role)**

The three building blocks behind templates.

