Skip to content

Commit 6d4df1d

Browse files
add docs for new rg min role to create
1 parent 0c5cefa commit 6d4df1d

File tree

2 files changed

+14
-1
lines changed

2 files changed

+14
-1
lines changed

docs/hub/enterprise-resource-groups.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ This feature allows organization administrators to:
2525
- Assign different permission roles (read, contributor, write, admin) to team members
2626
- Keep private repositories visible only to authorized group members
2727
- Enable multiple teams to work independently within the same organization
28+
- Configure which member roles are allowed to create new resource groups
2829

2930
This Team & Enterprise feature helps organizations manage complex team structures and maintain proper access control over their repositories.
3031

docs/hub/security-resource-groups.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Head to your Organization's settings, then navigate to the "Resource Group" tab
3333
<img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/org-resource-groups-page-dark.png"/>
3434
</div>
3535

36-
If you are an admin of the organization, you can create and manage Resource Groups from that page.
36+
Organization admins can create and manage Resource Groups from that page. Depending on the organization's settings, members with lower roles may also be allowed to create resource groups (see [Who can create resource groups](#who-can-create-resource-groups) below).
3737

3838
After creating a resource group and giving it a meaningful name, you can start adding repositories and users to it.
3939

@@ -52,6 +52,18 @@ Remember that a repository can be part of only one Resource Group. You'll be war
5252
<img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/org-resource-groups-manage-move-repo-dark.png"/>
5353
</div>
5454

55+
## Who can create resource groups
56+
57+
By default, only organization admins can create new resource groups. Org admins can change this by setting the **minimum member role required to create resource groups** on the resource groups settings page.
58+
59+
The available options are:
60+
- **Admins only** (default) — only org admins can create resource groups.
61+
- **Write** — members with Write or Admin role can create resource groups.
62+
- **Contributor** — members with Contributor, Write, or Admin role can create resource groups.
63+
- **All members** — any org member can create resource groups.
64+
65+
When a non-admin member creates a resource group, they are automatically added as an **admin** of that newly created group. When creating a resource group via the API, non-admin creators must include at least one admin in the group's initial user list.
66+
5567
## Resource Groups API
5668

5769
You can list resource groups and add users to them (or change a member's org role and resource group assignments) via the Hub API. For the full reference, examples, and batch workflows, see the [Programmatic User Access Control Management](./programmatic-user-access-control) guide.

0 commit comments

Comments
 (0)