Project roles

For every project you create, you need to specify which users can access it. Each user can be assigned one role within the project:

• Owner
• Contributor
• Viewer

A user’s role determines what they can do within that project, as shown in the Role permissions tables below.

---

​

Add a user to a project

If you have the Owner role on a project or the Super Admin role on the account, you can add users to that project. To add a user to a project, and assign them a role:

1. From Your projects, select your project.
2. Navigate to the Access tab.
3. Click Add user.
4. Select a user from the User drop-down.
   • The drop-down displays every user defined in your account. If you want to invite new users to your account, read Manage other users.
   • To filter the list, begin typing a user’s name in the field.
5. Select a Project role for the user. Available roles are:
   • Owner
   • Contributor
   • Viewer
   For information on the available roles, read Role permissions.
6. Click Add to add the user.

---

​

Edit a user’s project role

Only users assigned the Owner role on a project can edit other users. To update a user’s project role:

1. From Your projects, select your project.
2. Navigate to the Access tab.
3. To change a user’s project role, click the three dots … for that user and click Edit user.

---

​

Remove a user from a project

Only users assigned the Owner role on a project can remove other users. When you remove a user, you delete their assigned role and completely revoke their access to the project. To remove a user:

1. From Your projects, select your project.
2. Navigate to the Access tab.
3. To remove a user from the associated project, click the three dots … for that user, and click Remove user.

---

​

Role permissions

The three user roles, Owner, Contributor, and Viewer, have specific permissions for the following features.

​

Owner role permissions

	Create	View	Update	Delete	Run
Projects	➖	✅	✅	✅	➖
Branches	✅	✅	✅	✅	➖
Environments	✅	✅	✅	✅	➖
Secret definitions	✅	✅	✅	✅	➖
OAuth connections	✅	✅	✅	✅	➖
Network items	✅	✅	✅	✅	➖
Pipelines	✅	✅	✅	✅	➖
Streaming pipelines	✅	✅	✅	✅	✅
Schemas	❌	✅	❌	❌	➖
Project variables	✅	✅	✅	✅	➖
	Commit	Merge	Pull	Reset
Git	✅	✅	✅	✅	➖
	Add	Edit	Remove	View
Users	✅	✅	✅	✅	➖

​

Contributor role permissions

	Create	View	Update	Delete	Run
Projects	➖	✅	❌	❌	➖
Branches	✅	✅	✅	✅	➖
Environments	❌	✅	❌	❌	➖
Secret definitions	✅	✅	✅	❌	➖
OAuth connections	✅	✅	✅	❌	➖
Network items	✅	✅	✅	❌	➖
Pipelines	✅	✅	✅	✅	➖
Streaming pipelines	✅	✅	✅	✅	✅
Schemas	❌	✅	❌	❌	➖
Project variables	✅	✅	✅	❌	➖
	Commit	Merge	Pull	Reset
Git	✅	✅	✅	✅	➖
	Add	Edit	Remove	View
Users	❌	❌	❌	✅	➖

​

Viewer role permissions

	Create	View	Update	Delete	Run
Projects	➖	✅	❌	❌	➖
Branches	❌	✅	❌	❌	➖
Environments	❌	✅	❌	❌	➖
Secret definitions	❌	✅	❌	❌	➖
OAuth connections	❌	✅	❌	❌	➖
Network items	❌	✅	❌	❌	➖
Pipelines	❌	✅	❌	❌	➖
Streaming pipelines	❌	✅	❌	❌	❌
Schemas	❌	✅	❌	❌	➖
Project variables	❌	✅	❌	❌	➖
	Commit	Merge	Pull	Reset
Git	❌	❌	❌	✅	➖
	Add	Edit	Remove	View
Users	❌	❌	❌	✅	➖

The tables above use these icons to show the permission levels for each role.