Updated on 2026-01-29 GMT+08:00

Managing Project Permission Templates

In CodeArts, you can simplify setting up project role permissions by reusing a permission template.

Constraints

Each account can create up to 20 permission templates in a single region.

Creating a Permission Template

  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.

  2. Click the username on the top navigation bar and choose All Account Settings.
  3. In the navigation pane, choose General > Project Permission Templates.
  4. On the Permission Templates tab, select a project type for which you want to create a template and click Create Permission Template.
  5. In the displayed dialog box, enter a template name and description, and click OK.

    Table 1 Creating a permission template

    Parameter

    Description

    Name

    The name of the permission template. Enter a maximum of 64 characters. Letters and digits are supported.

    Description

    Describe the permission template. Enter a maximum of 256 characters. Letters, digits, spaces, commas (,), periods (.), parentheses (()), and brackets ([]) are supported.

    This parameter is optional. Configure it as needed.

    The new permission template is displayed.

  6. Click in the Operation column. The Configure Permission Template page is displayed.
  7. Configure permissions for each role and click Save. By default, all system roles are displayed in the role list.

    Figure 1 Configuring the permission template
    Table 2 Configuring the permission template

    Parameter

    Description

    Configuring permissions for a role

    Click the target role and select required permissions.

    Adding a role

    Click Add Role. In the displayed dialog box, select the target role and click OK. Then, configure permissions for the role.

    If there is no role you want, click Create one. After creating a role, select it.

    Removing a role

    Click next to the target role. In the displayed dialog box, click Yes.

    To add the role again, click Add Role.

    When a success message shows up, the permission template configuration is complete.

Using a Permission Template in a Project

  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.

  2. Click the target project name.
  3. In the navigation pane, choose Settings > Permissions.
  4. Specify a template application mode and then select a template.

    Select either of the following modes:
    • Inherit: Use permissions of the selected template and modify them as needed. Template changes will not be synced here.
    • Associate: Use and sync permissions from the selected template.

  5. Click OK.

    Check the updated role permissions.

Managing a Permission Template

  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.

  2. Click the username on the top navigation bar and choose All Account Settings.
  3. Choose General > Project Permission Templates. The saved permission template is displayed.
  4. Locate the target template and perform the operations listed in the table below as needed.

    Table 3 Managing a permission template

    Operation

    Description

    Modifying the permission template

    Click in the Operation column. In the displayed dialog box, modify the template name and description, and click OK.

    The modified template information is displayed in the list.

    Configuring the permission template

    Click in the Operation column. Configure permissions for each role, and click Save.

    Check the updated permissions.

    Deleting the permission template

    WARNING:

    The deletion cannot be undone. Exercise caution when performing this operation.

    Click in the Operation column. In the displayed dialog box, confirm the operation, and click OK.

    The deleted template is no longer displayed in the list.

Setting a Custom Role

If the built-in system roles of CodeArts do not meet your permission template requirements, you can create one with necessary permissions.

  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.

  2. Click the username on the top navigation bar and choose All Account Settings.
  3. In the navigation pane, choose General > Project Permission Templates.
  4. On the Roles tab, select a project type for which you want to create a role, and click Create Role.
  5. In the displayed dialog box, enter a role name and description, and click OK.

    Table 4 Creating a role

    Parameter

    Description

    Role Name

    The name of the custom role. Do not use a system role name.

    Enter a maximum of 30 characters. Letters, digits, spaces, and the following special characters are supported: () [] - _ ~. & <> {}

    Description

    Describe the role. Enter a maximum of 120 characters.

    This parameter is optional. Configure it as needed.

    The new role is displayed.

  6. Click in the Operation column. The Configure Permissions page is displayed.
  7. Select required permissions and click Save.

    When a success message shows up, the role configuration is complete.