Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 41 additions & 30 deletions docs/hub/_toctree.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,40 @@
- local: index
title: 🤗 Hugging Face Hub

- local: enterprise-hub
title: Team & Enterprise Plans
isExpanded: true
sections:
- local: enterprise-sso
title: Single Sign-On (SSO)
- local: enterprise-hub-advanced-sso
title: Advanced Single Sign-On (SSO)
- local: enterprise-hub-scim
title: User Provisioning (SCIM)
- local: audit-logs
title: Audit Logs
- local: storage-regions
title: Storage Regions
- local: enterprise-hub-datasets
title: Data Studio for Private datasets
- local: enterprise-hub-resource-groups
title: Resource Groups (Access Control)
- local: advanced-compute-options
title: Advanced Compute Options
- local: enterprise-hub-advanced-security
title: Advanced Security
- local: enterprise-hub-tokens-management
title: Tokens Management
- local: enterprise-hub-analytics
title: Publisher Analytics
- local: enterprise-hub-network-security
title: Network Security
- local: enterprise-hub-gating-group-collections
title: Gating Group Collections

- local: pro
title: PRO Plan

- local: repositories
title: Repositories
isExpanded: true
Expand Down Expand Up @@ -33,6 +68,7 @@
title: Next Steps
- local: repositories-licenses
title: Licenses

- title: Models
local: models
isExpanded: true
Expand Down Expand Up @@ -154,6 +190,7 @@
title: GGUF usage with Ollama
- local: dduf
title: DDUF

- title: Datasets
local: datasets
isExpanded: true
Expand Down Expand Up @@ -241,6 +278,7 @@
title: Image Dataset
- local: datasets-video
title: Video Dataset

- local: spaces
title: Spaces
isExpanded: true
Expand Down Expand Up @@ -336,6 +374,7 @@
title: Cookie limitations in Spaces
- local: spaces-handle-url-parameters
title: Set URL query and hash

- local: other
title: Other
isExpanded: true
Expand All @@ -349,35 +388,6 @@
title: Organization Cards
- local: organizations-security
title: Access Control in Organizations
- local: enterprise-hub
title: Team & Enterprise Plans
sections:
- local: enterprise-sso
title: Single Sign-On (SSO)
- local: enterprise-hub-advanced-sso
title: Advanced Single Sign-On (SSO)
- local: enterprise-hub-scim
title: User Provisioning (SCIM)
- local: audit-logs
title: Audit Logs
- local: storage-regions
title: Storage Regions
- local: enterprise-hub-datasets
title: Data Studio for Private datasets
- local: enterprise-hub-resource-groups
title: Resource Groups (Access Control)
- local: advanced-compute-options
title: Advanced Compute Options
- local: enterprise-hub-advanced-security
title: Advanced Security
- local: enterprise-hub-tokens-management
title: Tokens Management
- local: enterprise-hub-analytics
title: Publisher Analytics
- local: enterprise-hub-network-security
title: Network Security
- local: enterprise-hub-gating-group-collections
title: Gating Group Collections
- local: billing
title: Billing
- local: security
Expand Down Expand Up @@ -408,7 +418,6 @@
title: How to configure SCIM with EntraID (Azure AD)
- local: security-sso-google-saml
title: How to configure SAML with Google Workspace

- local: security-resource-groups
title: Advanced Access Control (Resource Groups)
- local: security-malware
Expand All @@ -427,6 +436,8 @@
title: Moderation
- local: paper-pages
title: Paper Pages
- local: academia-hub
title: Academia Hub
- local: search
title: Search
- local: doi
Expand Down
17 changes: 9 additions & 8 deletions docs/hub/billing.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ Any feedback or support request related to billing is welcome at billing@hugging

## Team and Enterprise subscriptions

We offer advanced security and compliance features for organizations through our Team or Enterprise subscription, including [Single Sign-On](./enterprise-sso), [Advanced Access Control](./enterprise-hub-resource-groups) for repositories, control over your data location, higher [storage capacity](./storage-limits) for private repositories, and more.
We offer advanced security and compliance features for organizations through our Team or Enterprise plans, which include [Single Sign-On](./enterprise-sso), [Advanced Access Control](./enterprise-hub-resource-groups) for repositories, control over your data location, higher [storage capacity](./storage-limits) for public and private repositories, and more.

The Enterprise Hub is billed like a typical subscription. It renews automatically, but you can choose to cancel it at any time in the organization's billing settings.
Team and Enterprise plans are billed like a typical subscription. They renew automatically, but you can choose to cancel at any time in the organization's billing settings.

You can pay for a Team subscription with a credit card or your AWS account, or upgrade to Enterprise via an annual contract.

Expand All @@ -23,23 +23,24 @@ Private repository storage above the [included storage](./storage-limits) will b

## PRO subscription

The PRO subscription unlocks additional features for users, including:
The PRO subscription unlocks essential features for serious users, including:

- Higher [storage capacity](./storage-limits) for public and private repositories
- Higher tier for ZeroGPU Spaces usage
- Ability to create ZeroGPU Spaces and use Dev Mode
- Included credits for [Inference Providers](/docs/inference-providers/)
- Higher [storage capacity](./storage-limits) for private repositories
- Ability to write Social Posts and Community Blogs
- Leverage the Dataset Viewer on private datasets
- Ability to publish Social Posts and Community Blogs
- Leverage the Data Studio on private datasets
- Run and schedule serverless [CPU/ GPU Jobs](https://huggingface.co/docs/huggingface_hub/en/guides/jobs)

View the full list of benefits at https://huggingface.co/subscribe/pro
View the full list of benefits at https://huggingface.co/pro then subscribe over at https://huggingface.co/subscribe/pro

Similarly to the Enterprise Hub subscription, PRO subscriptions are billed like a typical subscription. The subscription renews automatically for you. You can choose to cancel the subscription at anytime in your billing settings: https://huggingface.co/settings/billing

You can only pay for the PRO subscription with a credit card. The subscription is billed separately from any pay-as-you-go compute usage.
Private repository storage above the [included storage](./storage-limits) will be billed along with your subscription renewal.

Note: PRO benefits are also included in the Enterprise Hub subscription.
Note: PRO benefits are also included in the [Enterprise subscription](https://huggingface.co/enterprise).

## Pay-as-you-go private storage

Expand Down
2 changes: 1 addition & 1 deletion docs/hub/datasets-adding.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ For most types of datasets, **Parquet** is the recommended format due to its eff
### Data Studio

The [Data Studio](./datasets-viewer) is useful to know how the data actually looks like before you download it.
It is enabled by default for all public datasets. It is also available for private datasets owned by a [PRO user](https://huggingface.co/pricing) or an [Enterprise Hub organization](https://huggingface.co/enterprise).
It is enabled by default for all public datasets. It is also available for private datasets owned by a [PRO user](https://huggingface.co/pricing) or a [Team or Enterprise organization](https://huggingface.co/enterprise).

After uploading your dataset, make sure the Dataset Viewer correctly shows your data, or [Configure the Dataset Viewer](./datasets-viewer-configure).

Expand Down
2 changes: 1 addition & 1 deletion docs/hub/datasets-viewer-configure.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ viewer: false

## Private datasets

For **private** datasets, the Dataset Viewer is enabled for [PRO users](https://huggingface.co/pricing) and [Enterprise Hub organizations](https://huggingface.co/enterprise).
For **private** datasets, the Dataset Viewer is enabled for [PRO users](https://huggingface.co/pricing) and [Team or Enterprise organizations](https://huggingface.co/enterprise).
2 changes: 1 addition & 1 deletion docs/hub/datasets-viewer.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,6 @@ For more information see our guide on [How to embed the Dataset Viewer in a webp
To have a properly working Dataset Viewer for your dataset, make sure your dataset is in a supported format and structure.
There is also an option to configure your dataset using YAML.

For **private** datasets, the Dataset Viewer is enabled for [PRO users](https://huggingface.co/pricing) and [Enterprise Hub organizations](https://huggingface.co/enterprise).
For **private** datasets, the Dataset Viewer is enabled for [PRO users](https://huggingface.co/pricing) and [Team or Enterprise organizations](https://huggingface.co/enterprise).

For more information see our guide on [How to configure the Dataset Viewer](./datasets-viewer-configure).
4 changes: 2 additions & 2 deletions docs/hub/enterprise-hub.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,12 @@ In this section we will document the following Enterprise Hub features:
- [User Provisioning (SCIM)](./enterprise-hub-scim)
- [Audit Logs](./audit-logs)
- [Storage Regions](./storage-regions)
- [Dataset viewer for Private datasets](./enterprise-hub-datasets)
- [Data Studio for Private datasets](./enterprise-hub-datasets)
- [Resource Groups](./security-resource-groups)
- [Advanced Compute Options](./advanced-compute-options)
- [Advanced Security](./enterprise-hub-advanced-security)
- [Tokens Management](./enterprise-hub-tokens-management)
- [Analytics](./enterprise-hub-analytics)
- [Publisher Analytics](./enterprise-hub-analytics)
- [Network Security](./enterprise-hub-network-security)
- [Gating Group Collections](./enterprise-hub-gating-group-collections)

Expand Down
16 changes: 15 additions & 1 deletion docs/hub/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,21 @@ The Hugging Face Hub is a platform with over 1.7M models, 400k datasets, and 600

<div class="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3 md:mt-10">

<div class="group flex flex-col space-y-2 rounded-xl border border-purple-100 bg-linear-to-br from-purple-50 dark:bg-none px-6 py-4 transition-colors hover:shadow-sm dark:border-purple-700">
<div class="flex items-center py-0.5 text-lg font-semibold text-purple-600 dark:text-gray-400 mb-1">
<svg class="shrink-0 mr-1.5 text-purple-500" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" focusable="false" role="img" width="1em" height="1em" viewBox="0 0 32 32"><path fill="currentColor" d="M11.61 29.92a1 1 0 0 1-.6-1.07L12.83 17H8a1 1 0 0 1-1-1.23l3-13A1 1 0 0 1 11 2h10a1 1 0 0 1 .78.37a1 1 0 0 1 .2.85L20.25 11H25a1 1 0 0 1 .9.56a1 1 0 0 1-.11 1l-13 17A1 1 0 0 1 12 30a1.1 1.1 0 0 1-.39-.08M17.75 13l2-9H11.8L9.26 15h5.91l-1.59 10.28L23 13Z"/></svg> Subscriptions & Plans</div>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./pro">PRO subscription</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./enterprise-hub">Team & Enterprise Plans</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./enterprise-sso">Single Sign-On (SSO)</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./audit-logs">Audit Logs</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./storage-regions">Storage Regions</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./enterprise-hub-datasets">Data Studio for Private datasets</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./security-resource-groups">Resource Groups</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./enterprise-hub-advanced-security">Advanced Security</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./enterprise-hub-tokens-management">Tokens Management</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./enterprise-hub-network-security">Network Security</a>
</div>

<div class="group flex flex-col space-y-2 rounded-xl border border-orange-100 bg-linear-to-br from-orange-50 dark:bg-none px-6 py-4 transition-colors hover:shadow-sm dark:border-orange-700">
<div class="flex items-center py-0.5 text-lg font-semibold text-orange-600 dark:text-gray-400 mb-1">
<svg class="shrink-0 mr-1.5 text-orange-500" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 24 24"><path fill="currentColor" d="M2.6 10.59L8.38 4.8l1.69 1.7c-.24.85.15 1.78.93 2.23v5.54c-.6.34-1 .99-1 1.73a2 2 0 0 0 2 2a2 2 0 0 0 2-2c0-.74-.4-1.39-1-1.73V9.41l2.07 2.09c-.07.15-.07.32-.07.5a2 2 0 0 0 2 2a2 2 0 0 0 2-2a2 2 0 0 0-2-2c-.18 0-.35 0-.5.07L13.93 7.5a1.98 1.98 0 0 0-1.15-2.34c-.43-.16-.88-.2-1.28-.09L9.8 3.38l.79-.78c.78-.79 2.04-.79 2.82 0l7.99 7.99c.79.78.79 2.04 0 2.82l-7.99 7.99c-.78.79-2.04.79-2.82 0L2.6 13.41c-.79-.78-.79-2.04 0-2.82Z"></path></svg>Repositories</div>
Expand Down Expand Up @@ -70,7 +85,6 @@ The Hugging Face Hub is a platform with over 1.7M models, 400k datasets, and 600
<div class="flex items-center py-0.5 text-lg font-semibold text-green-600 dark:text-gray-400 mb-1">
<svg class="shrink-0 mr-1.5 text-green-500" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" focusable="false" role="img" width="1em" height="1em" viewBox="0 0 24 24"><path fill="currentColor" stroke="currentColor" d="M8.892 21.854a6.25 6.25 0 0 1-4.42-10.67l7.955-7.955a4.5 4.5 0 0 1 6.364 6.364l-6.895 6.894a2.816 2.816 0 0 1-3.89 0a2.75 2.75 0 0 1 .002-3.888l5.126-5.127a1 1 0 1 1 1.414 1.414l-5.126 5.127a.75.75 0 0 0 0 1.06a.768.768 0 0 0 1.06 0l6.895-6.894a2.503 2.503 0 0 0 0-3.535a2.56 2.56 0 0 0-3.536 0l-7.955 7.955a4.25 4.25 0 1 0 6.01 6.01l6.188-6.187a1 1 0 1 1 1.414 1.414l-6.187 6.186a6.206 6.206 0 0 1-4.42 1.832z"></path></svg> Other</div>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./organizations">Organizations</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./enterprise-hub">Team & Enterprise plans</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./billing">Billing</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./security">Security</a>
<a class="no-underline! hover:opacity-60 transform transition-colors hover:translate-x-px" href="./moderation">Moderation</a>
Expand Down
16 changes: 4 additions & 12 deletions docs/hub/organizations.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,7 @@ If an organization needs to track user access to a dataset or a model due to lic
- [Managing Organizations](./organizations-managing)
- [Organization Cards](./organizations-cards)
- [Access Control in Organizations](./organizations-security)
- [Enterprise Hub features](./enterprise-hub)
- [SSO](./enterprise-sso)
- [Advanced SSO](./enterprise-hub-advanced-sso)
- [User Provisioning (SCIM)](./enterprise-hub-scim)
- [Audit Logs](./audit-logs)
- [Storage Regions](./storage-regions)
- [Dataset viewer for Private datasets](./enterprise-hub-datasets)
- [Resource Groups](./security-resource-groups)
- [Advanced Compute Options](./advanced-compute-options)
- [Advanced Security](./enterprise-hub-advanced-security)
- [Tokens Management](./enterprise-hub-tokens-management)
- [Analytics](./enterprise-hub-analytics)

## Next: Power up your organization

- [Team & Enterprise Plans](./enterprise-hub)
13 changes: 13 additions & 0 deletions docs/hub/pro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# The HF PRO subscription 🔥

The PRO subscription unlocks essential features for serious users, including:

- Higher [storage capacity](./storage-limits) for public and private repositories
- Higher tier for [ZeroGPU Spaces](./spaces-zerogpu) usage
- Ability to create ZeroGPU Spaces and use [Dev Mode](./spaces-dev-mode)
- Included credits for [Inference Providers](/docs/inference-providers/)
- Ability to publish Social Posts and Community Blogs
- Leverage the Data Studio on private datasets
- Run and schedule serverless [CPU/ GPU Jobs](https://huggingface.co/docs/huggingface_hub/en/guides/jobs)

View the full list of benefits at **https://huggingface.co/pro** then subscribe over at https://huggingface.co/subscribe/pro
2 changes: 1 addition & 1 deletion docs/hub/storage-backends.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ To start using Xet Storage, you need a Xet-enabled repository and a Xet-aware ve

For user and organization profiles created before May 23rd, 2025, you can make Xet the default for all your repositories by [signing up here](https://huggingface.co/join/xet). You can apply for yourself or your entire organization (requires [admin permissions](https://huggingface.co/docs/hub/organizations-security)). Once approved, all existing repositories will be automatically migrated to Xet and future repositories will be Xet-enabled by default.

PRO users and Enterprise Hub organizations will be fast-tracked for access.
PRO users and Team or Enterprise organizations will be fast-tracked for access.

</Tip>

Expand Down
4 changes: 2 additions & 2 deletions docs/hub/storage-limits.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ We do have mitigations in place to prevent abuse of free public storage, and in

💡 [Team or Enterprise Organizations](https://huggingface.co/enterprise) include 1TB of private storage per seat in the subscription: for example, if your organization has 40 members, then you have 40TB of included private storage.

\*We aim to continue providing the AI community with free storage space for public repositories. Please use this resource responsibly by uploading content that offers genuine value to other users - not dozens of TBs with limited community interest. If you need substantial storage space, you need to upgrade to [PRO, Team or Enterprise](https://huggingface.co/pricing).
\*We aim to continue providing the AI community with free storage space for public repositories. Beyond the first few gigabytes, please use this resource responsibly by uploading content that offers genuine value to other users. If you need substantial storage space, you will need to upgrade to [PRO, Team or Enterprise](https://huggingface.co/pricing).


### Pay-as-you-go price
Expand Down Expand Up @@ -121,7 +121,7 @@ If you need more model/ dataset storage than your allocated private storage for

## How can I free up storage space in my account/organization?

There are several ways to manage and free some storage space in your account or organization. First, if you need more storage space, consider upgrading to PRO or Enterprise Hub plans for increased storage limits.
There are several ways to manage and free some storage space in your account or organization. First, if you need more storage space, upgrade to a PRO, Team or Enterprise plan for increased storage limits.

⚠️ **Important**: Deleting LFS files is a destructive operation that cannot be undone. Make sure to backup your files before proceeding.

Expand Down