<a id="setting-up-project-roles"></a>
<a id="admin-guide-project-roles"></a>
# Setting up Project Roles

A Project Role is a named set of permissions for working in a Project and its Drafts. Roles such as "Study Builder", "Reviewer" or "Test Author" are defined once for your Organization. They can then be used in every Project, in every URL your Organization owns.

Set up your Project Roles before you invite people. When you invite someone to a Project you choose one of these roles for them.

<a id="creating-a-project-role"></a>
## Creating a Project Role

1. Go to your Organization home page.
2. Click the **Project Roles** card.
3. Click **Add Project Role**.
4. Enter a name and a description.
5. Switch on the permissions the role needs. **Select All** and **Select None** help when a role needs most or few of them.
6. Click **Save**.

Each permission is described on the [Project Role permissions](../urls/project_roles/project_role_permissions.html.md#project-role-permissions) page.

If your Organization's license does not include a permission, you will not be able to switch it on. See [Project Roles and licenses](licenses.html.md#admin-guide-licenses).

> **Tip:** When you are starting out, a single role with every permission lets you begin work straight away. As your team grows, add roles with fewer permissions and move people to them.

<a id="changing-a-project-role"></a>
## Changing a Project Role

Open the role from the Project Roles list to change its name, description or permissions. The change applies straight away to everyone who holds the role, in every Project.

<a id="merging-project-roles"></a>
## Merging Project Roles

If two roles have become the same in practice, you can merge them.

1. On the Project Roles list, select two or more roles.
2. Click **Merge**.
3. Choose the name and description to keep. The dialog shows the permissions the merged role will have.
4. Click **Merge Roles**.

The merged role has every permission that any of the selected roles had. Everyone who held one of them now holds the merged role.

<a id="deleting-a-project-role"></a>
## Deleting a Project Role

> **Warning:** Deleting a Project Role removes everyone who holds it from their role in every Project. They will no longer be able to work in those Projects until they are given another role.

> **See also:** [Project Roles](../urls/project_roles/index.html.md#project-roles), [Project Roles](../urls/project_roles/project_role_definitions.html.md#url-role-permissions) and [Project Role Permissions](../urls/project_roles/project_role_permissions.html.md#project-role-permissions).
