Gating Group Collections

docs/hub/_toctree.yml

@@ -350,6 +350,8 @@
       title: Analytics
     - local: enterprise-hub-network-security
       title: Network Security
+    - local: enterprise-hub-gating-group-collections
+      title: Network Security
   - local: billing
     title: Billing
   - local: security

docs/hub/collections.md

@@ -11,6 +11,7 @@ Collections have many use cases:
 - Showcase and share a complete project with its paper(s), dataset(s), model(s) and Space(s).
 - Bookmark things you find on the Hub in categories.
 - Have a dedicated page of curated things to share with others.
+- Gate a group of models/datasets (Enterprise only)
 
 This is just a list of possible uses, but remember that collections are just a way of grouping things, so use them in the way that best fits your use case.
 
@@ -54,6 +55,14 @@ Use the **history feature** to keep track of who has edited the collection.
 
 Set your collection to **private** if you don't want it to be accessible via its URL (it will not be displayed on your profile/organization page). For organizations, private collections are only available to members of the organization.
 
+### Gating Group Collection (Enterprise only)
+
+For [Enterprise Hub](https://huggingface.co/docs/hub/en/enterprise-hub) subscribers, you can gate all the repos in a collection, enabling **a single access requests** for all models and datasets in it.
+
+This feature allows you to restrict access to specific collections: users must agree to share their contact information (username and email address) with the organization to access the models and datasets files when enabled.
+
+Please note that this feature is only available to Enterprise subscribers: more information about Gating Group Collection can be found in [our doc](https://huggingface.co/docs/hub/en/enterprise-hub-gating-group-collections).
+
 ### Ordering your collections and their items
 
 You can use the drag and drop handles in the collections list (on the left side of your collections page) to change the order of your collections (1). The first two collections will be directly visible on your profile/organization pages.
@@ -85,7 +94,6 @@ To start adding images to your collection, you can click on the image icon in th
 
 Then, add images by dragging and dropping images from your computer. You can also click on the gray zone to select image files from your computer's file system.
 
-
 ![Collection image drop zone with images](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collections-image-gallery.webp)
 
 You can re-order images by drag-and-dropping them. Clicking on an image will open it in full-screen mode.

docs/hub/datasets-gated.md

@@ -125,6 +125,12 @@ extra_gated_button_content: "Acknowledge license"
 ---
 ```
 
+## Manage gated datasets as an organization (Enterprise Hub)
+
+For [Enterprise Hub](https://huggingface.co/docs/hub/en/enterprise-hub) subscribers, you can gate all the repos in a Gating Group collection, enabling **a single access requests** for all datasets (and/or models) in it.
+
+More information about Gating Group collections can be found in [our doc](https://huggingface.co/docs/hub/en/enterprise-hub-gating-group-collections).
+
 ## Access gated datasets as a user
 
 

docs/hub/enterprise-hub-gating-group-collections.md

@@ -0,0 +1,71 @@
+# Gating Group Collections
+
+<Tip warning={true}>
+This feature is part of the <a href="https://huggingface.co/enterprise">Enterprise Hub</a>.
+</Tip>
+
+Gating Group collections allows organizations to configure gate all the repos in a collection, enabling **access requests** for all models or datasets in it.
+
+## Manage gating group as an organization admin
+
+To enable access requests, go to the collection page and click on **Gating group** in the bottom-right corner.
+
+<div class="flex justify-center" style="max-width: 750px">
+    <img
+        class="block dark:hidden !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-collection-disabled.webp"
+        alt="Hugging Face collection page with gating group collection feature disabled"
+    />
+    <img
+        class="hidden dark:block !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-collection-disabled.webp"
+        alt="Hugging Face collection page with gating group collection feature disabled"
+    />
+</div>
+
+By default, gating group is disabled: click on **Configure Access Requests** to open the settings
+
+<div class="flex justify-center" style="max-width: 750px">
+    <img
+        class="block dark:hidden !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-disabled.webp"
+        alt="Hugging Face gating group collection settings with gating disabled"
+    />
+    <img
+        class="hidden dark:block !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-disabled.webp"
+        alt="Hugging Face gating group collection settings with gating disabled"
+    />
+</div>
+
+By default, access to the repos in the collection is automatically granted to the user when requesting it. This is referred to as **automatic approval**. In this mode, any user can access your repos once they’ve shared their personal information with you.
+
+<div class="flex justify-center" style="max-width: 750px">
+    <img
+        class="block dark:hidden !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-enabling.webp"
+        alt="Hugging Face gating group collection settings with automatic mode selected"
+    />
+    <img
+        class="hidden dark:block !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-enabling.webp"
+        alt="Hugging Face gating group collection settings with gating with automatic mode selected"
+    />
+</div>
+
+If you want to manually approve which users can access repos in your collection, you must set it to **manual approval**. When this is the case, you will notice a new option:
+
+<div class="flex justify-center" style="max-width: 750px">
+    <img
+        class="block dark:hidden !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-changes.webp"
+        alt="Hugging Face gating group collection settings with manual review mode selected"
+    />
+    <img
+        class="hidden dark:block !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-changes.webp"
+        alt="Hugging Face gating group collection settings with manual review mode selected"
+    />
+</div>
+
+**Notification frequency** lets you configure when to get notified if new users request access. It can be set to once a day or real-time. By default, emails are sent to the first 5 admins of the organization. You can also set a different email address in the **Notifications email** field.

docs/hub/enterprise-hub.md

@@ -23,5 +23,6 @@ In this section we will document the following Enterprise Hub features:
 - [Tokens Management](./enterprise-hub-tokens-management)
 - [Analytics](./enterprise-hub-analytics)
 - [Network Security](./enterprise-hub-network-security)
+- [Gating Group Collections](./enterprise-hub-gating-group-collections)
 
 Finally, Enterprise Hub includes 1TB of [private repository storage](./storage-limits) per seat in the subscription, i.e. if your organization has 40 members, then you have 40TB included storage for your private models and datasets.

docs/hub/models-gated.md

@@ -139,6 +139,12 @@ Possible use cases of programmatic management include:
     - Here's an [example repo](https://huggingface.co/Trelis/openchat_3.5-function-calling-v3) from TrelisResearch that uses this use case.
    - [@RonanMcGovern](https://huggingface.co/RonanMcGovern) has posted a [video about the flow](https://www.youtube.com/watch?v=2OT2SI5auQU) and tips on how to implement it.
 
+## Manage gated models as an organization (Enterprise Hub)
+
+For [Enterprise Hub](https://huggingface.co/docs/hub/en/enterprise-hub) subscribers, you can gate all the repos in a Gating Group collection, enabling **access requests** for all models (and/or datasets) in it.
+
+More information about Gating Group collections can be found in [our doc](https://huggingface.co/docs/hub/en/enterprise-hub-gating-group-collections).
+
 ## Access gated models as a user