From e08e379a6be0a94542e643091bf58332d6e57467 Mon Sep 17 00:00:00 2001 From: Muhammadsaeed707 Date: Thu, 23 Jul 2026 12:47:21 -0400 Subject: [PATCH 1/4] fix and add download analytics page --- docs/hub/_toctree.yml | 2 ++ docs/hub/download-analytics.md | 30 ++++++++++++++++++++++++++++++ docs/hub/enterprise.md | 2 +- 3 files changed, 33 insertions(+), 1 deletion(-) create mode 100644 docs/hub/download-analytics.md diff --git a/docs/hub/_toctree.yml b/docs/hub/_toctree.yml index 926476d5fe..a40b64c2af 100644 --- a/docs/hub/_toctree.yml +++ b/docs/hub/_toctree.yml @@ -29,6 +29,8 @@ title: Gating Group Collections - local: enterprise-network-security title: Network Security + - local: download-analytics + title: Download Analytics - local: rate-limits title: Rate Limits - local: enterprise-blog-articles diff --git a/docs/hub/download-analytics.md b/docs/hub/download-analytics.md new file mode 100644 index 0000000000..e1a26e2b1b --- /dev/null +++ b/docs/hub/download-analytics.md @@ -0,0 +1,30 @@ +# Download Analytics + +Download Analytics gives organizations a bandwidth-level view of their Hugging Face usage: how much data is being downloaded and by whom. + +## Accessing Download Analytics + +Organization admins can find Download Analytics on the organization's Downloads settings page, at `https://huggingface.co/organizations//settings/downloads`. Individual users can see their own usage at `https://huggingface.co/settings/downloads`. + +## Egress overview + +The page shows a daily egress (download bandwidth) graph, along with your month-to-date total compared against your plan's included egress allowance. Only traffic that passes through the Hugging Face CDN is counted, and figures may increase over time as data settles. + +## Per-member breakdown + +For each member of the organization, the breakdown shows: + +- Total data downloaded, in bytes +- Date of their last download + +This gives admins a quick way to see who is driving bandwidth usage across the organization, at a glance. + +## Scope of the data + +Download Analytics reports total bandwidth per member; it does not record which specific repositories, revisions, or files were downloaded. + +If you publish your own models or datasets and want per-repository download counts for those repos, see [Publisher Analytics](./publisher-analytics). + +## Data availability and retention + +Historical data is available from when this feature rolled out; CDN usage metering is retained for 90 days. diff --git a/docs/hub/enterprise.md b/docs/hub/enterprise.md index 4c420bd1ce..1b44d3eff9 100644 --- a/docs/hub/enterprise.md +++ b/docs/hub/enterprise.md @@ -90,7 +90,7 @@ Team & Enterprise organization plans add advanced capabilities to organizations, | [Resource groups](./enterprise-advanced-security) | ❌ | ✅ | ✅ | ✅ | | [Tokens admin / management](./enterprise-tokens-management) | ❌ | ✅ | ✅ | ✅ | | [Token revocation](./enterprise-tokens-management#revoking-via-api) | ❌ | ❌ | ✅ | ✅ | -| [Users Download analytics](./enterprise-network-security) | ❌ | ❌ | ❌ | ✅ | +| [Download analytics](./download-analytics) | ✅ | ✅ | ✅ | ✅ | | [Content access / policy controls](./enterprise-network-security) | ❌ | ❌ | ❌ | ✅ | | [Network access controls](./enterprise-network-security) | ❌ | ❌ | ❌ | ✅ | | [Enforced authentication (advanced)](./enterprise-network-security) | ❌ | ❌ | ❌ | ✅ | From c2ff160a544aeb4db9dfa0593c5ccaf48d75d43d Mon Sep 17 00:00:00 2001 From: Muhammad Saeed <48301600+Muhammadsaeed707@users.noreply.github.com> Date: Thu, 23 Jul 2026 13:10:25 -0400 Subject: [PATCH 2/4] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/hub/download-analytics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hub/download-analytics.md b/docs/hub/download-analytics.md index e1a26e2b1b..ffe5a05d29 100644 --- a/docs/hub/download-analytics.md +++ b/docs/hub/download-analytics.md @@ -4,7 +4,7 @@ Download Analytics gives organizations a bandwidth-level view of their Hugging F ## Accessing Download Analytics -Organization admins can find Download Analytics on the organization's Downloads settings page, at `https://huggingface.co/organizations//settings/downloads`. Individual users can see their own usage at `https://huggingface.co/settings/downloads`. +Organization admins can find Download Analytics on the organization's Downloads settings page, at `https://huggingface.co/organizations/[organizationIdentifier]/settings/downloads`. Individual users can see their own usage at `https://huggingface.co/settings/downloads`. ## Egress overview From f36574891b31f02d26cd0ab9b3104c8fd8841c8b Mon Sep 17 00:00:00 2001 From: Muhammadsaeed707 Date: Thu, 23 Jul 2026 13:17:29 -0400 Subject: [PATCH 3/4] fix wording --- docs/hub/download-analytics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hub/download-analytics.md b/docs/hub/download-analytics.md index ffe5a05d29..7c1a8886a9 100644 --- a/docs/hub/download-analytics.md +++ b/docs/hub/download-analytics.md @@ -27,4 +27,4 @@ If you publish your own models or datasets and want per-repository download coun ## Data availability and retention -Historical data is available from when this feature rolled out; CDN usage metering is retained for 90 days. +CDN usage metering is retained for 90 days. From 598a25113234d119382dbaefc327b5ed2227516a Mon Sep 17 00:00:00 2001 From: Muhammadsaeed707 Date: Wed, 29 Jul 2026 13:13:13 -0400 Subject: [PATCH 4/4] add screenshot --- docs/hub/download-analytics.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/hub/download-analytics.md b/docs/hub/download-analytics.md index 7c1a8886a9..1dfb9dc5d4 100644 --- a/docs/hub/download-analytics.md +++ b/docs/hub/download-analytics.md @@ -2,6 +2,19 @@ Download Analytics gives organizations a bandwidth-level view of their Hugging Face usage: how much data is being downloaded and by whom. +
+ screenshot of the organization Downloads settings page, showing daily egress usage and the per-member breakdown + +
+ ## Accessing Download Analytics Organization admins can find Download Analytics on the organization's Downloads settings page, at `https://huggingface.co/organizations/[organizationIdentifier]/settings/downloads`. Individual users can see their own usage at `https://huggingface.co/settings/downloads`.