Create and manage custom roles
This article describes Confluence’s new role-based access control beta feature.
When roles are enabled in your Confluence instance, you can find them by going to Confluence settings > Security > Space permissions > Manage roles or to the Users page in Space settings.
If you don’t see those in your experience, your instance hasn’t been enabled for roles yet.
Custom roles give admins more flexibility and control over who can do what in their spaces outside of Confluence’s four default roles. While it’s important to limit the number of permissions configurations you need to manage, especially at scale, we know not all teams and organizations will fit neatly into the same buckets. Custom roles give you the flexibility to meet the unique needs of your team.
You can create up to 10 custom roles in Confluence.
Only Confluence product admins can create, edit, or delete custom roles. Space admins can assign custom roles within their spaces, but can't create or edit them.
Custom roles can be assigned to individual users, groups, and user classes (for example, “All Confluence users”).
Permissions dependencies
Some permissions or sets of permissions are connected to and have a dependency on other permissions. Granting or removing specific permissions for a custom role can affect other linked dependent permissions for that role.
Some examples:
Removing Edit content also removes Create content and Delete content.
Granting Delete space also grants Archive space.
Granting Export space also grants Export content in space.
Removing View content removes all other permissions. Conversely, granting any permission will also grant View content.
Granting Manage users also grants all content-level permissions (such as Edit content or Delete comment.)
Manage space and space settings grants all permissions across the space.
Add a custom role
カスタム ロールを作成するには、次の手順を実行します。
Go to Confluence settings > Permissions > Roles.
Select Create custom role.
Enter a name and a description.
A complete description will help document the purpose and scope of your custom roles for space admins and users.
Choose the permissions for this role (e.g., “View content”, “Edit content”, “Manage user access to space”).
As mentioned above, some permissions are dependent on holding other permissions.
[保存] を選択します。
Your new role will now appear in role selectors to be assigned to users, groups, and user classes.
カスタム ロールを編集する
Editing a role's permissions impacts all users assigned to that role.
カスタム ロールを編集するには、次の手順を実行します。
Go to the Roles section in Confluence settings.
Find the custom role and select Edit.
Modify the name, description, or permissions.
[保存] を選択します。
カスタム ロールを削除する
When you delete a role, you can reassign anyone who holds that role to a new role.
To delete a custom role:
Make sure no one is assigned the role you want to delete.
Once all users have been reassigned, go to Product settings > Roles.
Find the role you want to delete and open the More actions () menu.
[削除] を選択します。
When should I create a custom role?
To keep managing access in Confluence simple and effective, aim to use the fewest number of roles necessary. The more unique roles and permissions you create, the harder it becomes to maintain and scale your access model.
Consider creating a custom role when:
Your team or organization has unique responsibilities or workflows that aren’t covered by the core roles.
You need to grant a specific set of permissions to a group of users that doesn’t fit existing roles.
You want to streamline access management for a recurring scenario (e.g., a project reviewer, external collaborator, or content publisher).
次の点にご注意ください。
Fewer roles make it easier to audit, update, and troubleshoot permissions.
Over-customizing can lead to confusion and administrative overhead, especially as your organization grows.
この内容はお役に立ちましたか?