Step 1: Create Project Roles

JFrog Platform Administration Documentation

Content Type
Administration / Platform

Note

To create a project role, you must be assigned a Platform Administrator role or a Project Admin role.

You can create a maximum of 30 roles per project.

  1. From the Projects list, select the project on which to assign the role.

  2. Click Administration on the taskbar, then navigate to User Management | Roles.

    On the Project level, navigate to User Management | Roles, if you use the classic navigation. Classic navigation is available for JFrog self-hosted customers with version 7.90 or previous only.

  3. In the Project Roles tab, click Create Project Roles and configure the role settings:

    1. Type your user-defined Project Role name.

    2. (Optional) Assign one or more environments to the role by selecting from the Global Environments and Project Environments lists.

      create-project-role-a.png
    3. Set the Basic or Advanced role actions to assign to the role:

      • The Basic tab simplifies administration by bundling granular actions and resource types into logical categories. It allows you to grant broad functional capabilities without managing dozens of individual permissions. Use this view for standard roles where speed and ease of setup are the priorities.

      • The Advanced tab unbundles the categories defined in the Basic tab, providing direct control over every resource type and action. This allows you to create highly specific roles - such as allowing a user to “read” artifacts but not builds. Use this view to implement a strict “Least Privilege” model for specialized technical roles.

        Important

        Any actions settings made in the Advanced tab are removed if you move back from Advanced to Basic mode.

The following example shows the QA Tester role in the US R&D Project with advanced actions including Read and Write on repositories, delete Builds, promote Release Bundles, and the Trigger action on Pipelines.

dev-proje.png