Skip to content

Project Members

Project membership controls who can see and interact with a project's contents. While workspace membership determines who belongs to your organization, project membership determines who can work within a specific project. This two-level model lets you grant broad workspace access while keeping individual projects restricted to the people who need them.

How project membership works

  • A user must first be a workspace member before they can be added to any project.
  • Public projects are visible to all workspace members, but only project members can be assigned work items or manage settings.
  • Secret projects are invisible to non-members — they do not appear in the sidebar, search, or any listing.
  • Every project member has a role that controls their permissions within that project.

Add members to a project

  1. Open the project and go to Settings > Members.
  2. Click Add Member.
  3. Search for workspace members by name or email. You can select multiple members at once.
  4. Choose the role for the new members (Admin, Member, Viewer, or Guest).
  5. Click Add.

The added members immediately gain access to the project according to their assigned role.

TIP

When you create a new project, you are automatically added as its Admin. You can then invite other workspace members as needed.

Bulk add members

If you need to add many members at once:

  1. Go to Settings > Members.
  2. Click Add Member.
  3. Select all the workspace members you want to add from the dropdown.
  4. Assign them a common role.
  5. Click Add.

All selected members are added simultaneously with the same role. You can change individual roles afterward.

Project roles and permissions

Each project member is assigned one of four roles:

RoleDescription
AdminFull project control. Can manage settings, members, states, labels, estimates, automations, and all content.
MemberCan create, edit, and delete work items. Can participate in cycles, modules, and pages. Cannot change project settings or manage other members.
ViewerRead-only access to all project content. Can view work items, pages, cycles, and modules but cannot create or edit anything.
GuestRestricted read access. Intended for external stakeholders who need visibility into specific aspects of the project.

Detailed permission matrix

ActionAdminMemberViewerGuest
View work itemsYesYesYesYes
Create work itemsYesYesNoNo
Edit work itemsYesYesNoNo
Delete work itemsYesYesNoNo
Manage cyclesYesYesNoNo
Manage modulesYesYesNoNo
Create and edit pagesYesYesNoNo
Manage viewsYesYesYesNo
Change project settingsYesNoNoNo
Add or remove membersYesNoNoNo
Manage states and labelsYesNoNoNo
Configure estimatesYesNoNoNo
Configure automationsYesNoNoNo
Archive or delete the projectYesNoNoNo

Set the default project role

The default project role determines which role is automatically assigned when a new member joins the project (for example, when someone clicks Join Project on a public project).

  1. Go to Settings > Members.
  2. Find the Default Role dropdown.
  3. Select the desired role (Admin, Member, Viewer, or Guest).
  4. The setting is saved automatically.

TIP

For most teams, Member is the best default role. It gives new joiners the ability to contribute immediately without granting them administrative access.

Change a member's role

  1. Go to Settings > Members.
  2. Find the member in the list.
  3. Click the role dropdown next to their name.
  4. Select the new role.
  5. The change takes effect immediately.

WARNING

You cannot demote yourself from Admin if you are the only Admin on the project. Assign another Admin first before changing your own role.

Remove members

  1. Go to Settings > Members.
  2. Find the member you want to remove.
  3. Click the ... menu or the remove icon next to their name.
  4. Confirm the removal.

When a member is removed:

  • They immediately lose access to the project.
  • Work items assigned to them remain assigned but will appear as unresolvable references in some views.
  • Their past activity (comments, edits, state changes) is preserved in the project history.
  • For Secret projects, the project disappears from their sidebar entirely.

TIP

Before removing someone, consider reassigning their open work items to another member. Use the Bulk Edit feature in the work items view to reassign multiple items at once.

Member defaults for new items

Project Admins can configure default values that are applied when any member creates a new work item:

DefaultDescription
Default StateThe initial state assigned to new work items (configured in States)
Default PriorityThe initial priority level for new work items
Default AssigneeOptionally auto-assign new items to a specific member or the creator
Default LabelOptionally attach a label to all new items

These defaults reduce repetitive configuration and help maintain consistency across the project. They can be overridden on individual items at any time.

How project membership interacts with workspace roles

Workspace roles and project roles are independent but complementary:

Workspace RoleEffect on Projects
Workspace AdminCan access all projects (including Secret ones) and override project-level settings if needed. Automatically has Admin-equivalent access to every project.
Workspace MemberCan see Public projects and join them. Must be invited to Secret projects. Project-level role determines permissions.
Workspace GuestCan only access projects they are explicitly invited to. Limited to Guest or Viewer roles at the project level.

WARNING

A Workspace Admin can always access any project regardless of project-level membership. If you need to restrict a Workspace Admin from a project, you must change their workspace role first.

Best practices

  • Keep membership intentional — for Secret projects, only add the people who genuinely need access. Avoid adding the entire team "just in case."
  • Use Viewer for stakeholders — give managers, clients, or cross-functional partners Viewer access so they can follow progress without accidentally modifying anything.
  • Audit membership periodically — as teams change, review project members to remove people who have moved to other teams or left the organization.
  • Set the right default role — if your project is Public and many people self-join, make sure the default role matches what you want most members to do.