Help Center/ CodeArts/ User Guide/ Preparations/ Adding Project Members/ Associating Department Members
Updated on 2026-01-12 GMT+08:00

Associating Department Members

If there are multiple projects that need the same group of members in your account, you can add these members to a team and associate the department with the projects.

Constraints

  • A department can have a maximum of 5 levels.
  • A department can contain a maximum of 1,000 members.
  • A project can be associated with a maximum of 5 departments.
  • A department can be associated with a maximum of 100 projects.

Procedure

Step

Description

Step 1: Create a Department

Create a department. Ensure that you have the General > Members > Organization Structure > Create permission.

If you already have a department, skip this step.

To check the permissions of each tenant role, go to the All Account Settings > General > Tenant Permissions page.

Step 2: Associate a Department with a Project

Associate the team with your CodeArts project. Ensure that you have the General > Organization Structure > Associate Department permission.

How Do I Check and Obtain Required Project Permissions?

Step 1: Create a Department

  1. Go to the CodeArts homepage.

    1. Log in to the CodeArts console, click , and select a region where you have enabled CodeArts.
    2. Click Go to Workspace.

      If your account uses the old billing mode (see Old Billing Modes), click Access Service.

  1. Click the username on the top navigation bar and choose All Account Settings.
  2. Choose General > Members.
  3. Click the Organization Structure tab and create a department of the desired type.

    • Top-level department: Click Create.
    • Sub-department: Locate the target department and click .
    Figure 1 Creating a department

  4. In the displayed dialog box, enter a department name, select users, and click Next.

    The name can contain a maximum of 200 characters. Letters, digits, spaces, and the following special characters are supported: ()[]-_~.&

  5. Assign a role to each user and click OK.

    The new department is displayed. Click the department name to view its members.

Step 2: Associate a Department with a Project

  1. Go to the CodeArts homepage.
  2. Click the target project name to go to the project.
  3. In the navigation pane, choose Settings > Members.
  4. Click the Member Group View tab and click Associate on the right of Departments.
  5. In the displayed dialog box, select the department to be associated and click OK.

    Click the department name under Departments to view the members.

    On the Member View page, the members of the associated department are displayed in the list.

Other Operations

Manage your departments on the All Account Settings > General > Members > Organization Structure page.

To configure the permissions required for these operations, go to the All Account Settings > General > Tenant Permissions page.

Table 1 Managing departments

Operation

Step

Editing a department

  1. Locate the target department and click .
  2. In the displayed dialog box, enter a new name and click OK.

    The new department name is displayed.

Deleting a department

WARNING:
  • The members and sub-departments in the department will also be deleted and removed from associated projects.
  • The deletion cannot be undone. Exercise caution when performing this operation.
  1. Locate the target department and click .
  2. In the displayed dialog box, confirm the operation and click OK.

Managing department members

  • Adding a member
    1. Click the name of the target department. The department's members are displayed.
    2. Click Add Members above the list. In the displayed dialog box, select a user, assign a role, confirm the associated projects, and click OK.

      The new member is displayed in the list. Check this member on the Settings > Members page of each associated project.

  • Changing a member's role
    1. Click the name of the target department. The department's members are displayed.
    2. Locate the target member and click in the Operation column.
    3. In the displayed dialog box, select a new role and click OK.

      The new role is displayed in the member list. Check this member role on the Settings > Members page of each associated project.

  • Removing a member
    1. Click the name of the target department. The department's members are displayed.
    2. Locate the target member and click in the Operation column.
    3. In the displayed dialog box, confirm the operation and click OK.

      The member is no longer displayed in the list. Check this update on the Settings > Members page of each associated project.

Helpful Links