From 8f5046d16f59bbdeb821e8ccb3a830eeb0630546 Mon Sep 17 00:00:00 2001 From: Mishig Date: Mon, 18 May 2026 15:48:51 +0200 Subject: [PATCH 1/6] Add Blog Articles docs Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/hub/_toctree.yml | 2 ++ docs/hub/blog-articles.md | 43 ++++++++++++++++++++++++++++ docs/hub/enterprise-blog-articles.md | 8 ++++++ docs/hub/index.md | 2 ++ docs/hub/models-faq.md | 6 ++++ 5 files changed, 61 insertions(+) create mode 100644 docs/hub/blog-articles.md diff --git a/docs/hub/_toctree.yml b/docs/hub/_toctree.yml index 85141fa10d..01720e6add 100644 --- a/docs/hub/_toctree.yml +++ b/docs/hub/_toctree.yml @@ -552,6 +552,8 @@ title: Paper Pages - local: academia-hub title: Academia Hub + - local: blog-articles + title: Blog Articles - local: search title: Search - local: doi diff --git a/docs/hub/blog-articles.md b/docs/hub/blog-articles.md new file mode 100644 index 0000000000..ed5f3a5195 --- /dev/null +++ b/docs/hub/blog-articles.md @@ -0,0 +1,43 @@ +# Blog Articles + +Blog Articles let you publish long-form content directly on the Hub — model releases, research updates, tutorials, and announcements — and share them with the broader community. Articles can be published under your personal namespace or under an [organization](./organizations) you belong to. + +## Who Can Publish Blog Articles + +To publish under **your personal namespace**, you need a confirmed email and must satisfy at least one of the following: + +- You have an active [PRO](./pro) subscription. +- You are a member of a [Team or Enterprise](https://huggingface.co/enterprise) organization (with `write` or `admin` role in that organization). +- You have at least 100 followers on your Hugging Face profile. +- You are a member of the [`blog-explorers`](https://huggingface.co/blog-explorers) community organization. + +Managed users (users provisioned through Enterprise SSO) cannot publish under their personal namespace. + +To publish under an **organization namespace**, both must hold: + +- The organization is on the [Team or Enterprise](https://huggingface.co/enterprise) plan. +- You have the `write` or `admin` role in that organization (or a custom role with the `WriteBlog` permission). See [Access Control in Organizations](./organizations-security) for more on roles. + +See [Blog Articles for Organizations](./enterprise-blog-articles) for organization-specific details. + +## Creating a Blog Article + +Go to [huggingface.co/new-blog](https://huggingface.co/new-blog) to start a new article. You can write in Markdown, embed media, and reference models, datasets, and Spaces hosted on the Hub. + +When creating the article, pick the namespace it should be published under from the dropdown: + +- **Your username** — the article appears on your user profile. +- **An organization** — the article appears on that organization's profile page. + +## Editing an Article + +- Articles published under a user namespace can be edited by the original author and any coauthors listed on the article. +- Articles published under an organization namespace can be edited by any organization member with `write` or `admin` role (or a custom role with `WriteBlog`). + +## Linking to Models and Datasets + +When a blog article mentions a model or dataset, and the article's author (user or organization) is the same as the repo's owner, the article will automatically appear in the sidebar of that model or dataset page under **"Article(s) mentioning [repo-id]"**. Up to three of the most recent matching articles are shown. + +This makes it easy for visitors to discover related write-ups, release announcements, and research notes alongside the repository itself. + +If the article references a [Collection](./collections), every model and dataset in that collection is treated as linked — the article will surface on each member repo's page (subject to the same ownership rule). diff --git a/docs/hub/enterprise-blog-articles.md b/docs/hub/enterprise-blog-articles.md index f3bac9b6c2..0527ba156a 100644 --- a/docs/hub/enterprise-blog-articles.md +++ b/docs/hub/enterprise-blog-articles.md @@ -15,3 +15,11 @@ To publish blog articles under an organization namespace, members need `write` o > [!NOTE] > Blog article permissions are currently tied to organization-level roles and cannot be scoped using [Resource Groups](./security-resource-groups). Resource Groups only control access to repositories (models, datasets, and Spaces), not blog articles. + +## Linking to Models and Datasets + +When a blog article mentions a model or dataset owned by the same organization, the article will automatically appear in the sidebar of that model or dataset page under **"Article(s) mentioning [repo-id]"**. Up to three of the most recent matching articles are shown, making it easy for visitors to discover your organization's related content directly from the repository page. + +This also works for any models or datasets that belong to a [Collection](./collections) mentioned in the article — each member repo of a linked collection will surface the article on its page. + +See [Blog Articles](./blog-articles) for general information about authoring blog articles on the Hub. diff --git a/docs/hub/index.md b/docs/hub/index.md index 91552cbe55..780daedffb 100644 --- a/docs/hub/index.md +++ b/docs/hub/index.md @@ -133,6 +133,8 @@ The Hugging Face Hub is the reference AI platform for open ML. It hosts over 2M Security Moderation Paper Pages +Academia Hub +Blog Articles Search Digital Object Identifier (DOI) Hub API Endpoints diff --git a/docs/hub/models-faq.md b/docs/hub/models-faq.md index 3b4db4b03e..815c8e7196 100644 --- a/docs/hub/models-faq.md +++ b/docs/hub/models-faq.md @@ -22,6 +22,12 @@ The Hugging Face Hub is also home to Spaces, which are interactive demos used to Spaces are a great way to show off a model you've made or explore new ways to use existing models! Visit the [Spaces documentation](./spaces) to learn how to make your own. +## Are community blog articles linked to models? + +If you publish a [blog article](./blog-articles) that mentions a model and you are the same user or organization as the model's owner, the article will automatically appear in the model page sidebar under **"Article(s) mentioning [model-id]"**. Up to three of the most recent matching articles are shown. + +This makes it easy for visitors to discover related write-ups, release announcements, and research notes alongside the model itself. The same behavior applies to dataset pages. + ## How do I upload an update / new version of the model? Releasing an update to a model that you've already published can be done by pushing a new commit to your model's repo. To do this, go through the same process that you followed to upload your initial model. Your previous model versions will remain in the repository's commit history, so you can still download previous model versions from a specific git commit or tag or revert to previous versions if needed. From 2d3014eac7c24f149c537a4c8c6c02bace718646 Mon Sep 17 00:00:00 2001 From: Mishig Date: Mon, 18 May 2026 17:28:39 +0200 Subject: [PATCH 2/6] Update docs/hub/blog-articles.md Co-authored-by: Julien Chaumond --- docs/hub/blog-articles.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/hub/blog-articles.md b/docs/hub/blog-articles.md index ed5f3a5195..837f275bea 100644 --- a/docs/hub/blog-articles.md +++ b/docs/hub/blog-articles.md @@ -8,8 +8,6 @@ To publish under **your personal namespace**, you need a confirmed email and mus - You have an active [PRO](./pro) subscription. - You are a member of a [Team or Enterprise](https://huggingface.co/enterprise) organization (with `write` or `admin` role in that organization). -- You have at least 100 followers on your Hugging Face profile. -- You are a member of the [`blog-explorers`](https://huggingface.co/blog-explorers) community organization. Managed users (users provisioned through Enterprise SSO) cannot publish under their personal namespace. From b61e6c9952354e669cc9df01f0314335261f2827 Mon Sep 17 00:00:00 2001 From: Mishig Date: Mon, 18 May 2026 19:24:38 +0200 Subject: [PATCH 3/6] Drop custom-role and WriteBlog mentions from blog articles doc Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/hub/blog-articles.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/hub/blog-articles.md b/docs/hub/blog-articles.md index 837f275bea..7f8c5633ce 100644 --- a/docs/hub/blog-articles.md +++ b/docs/hub/blog-articles.md @@ -14,7 +14,7 @@ Managed users (users provisioned through Enterprise SSO) cannot publish under th To publish under an **organization namespace**, both must hold: - The organization is on the [Team or Enterprise](https://huggingface.co/enterprise) plan. -- You have the `write` or `admin` role in that organization (or a custom role with the `WriteBlog` permission). See [Access Control in Organizations](./organizations-security) for more on roles. +- You have the `write` or `admin` role in that organization. See [Access Control in Organizations](./organizations-security) for more on roles. See [Blog Articles for Organizations](./enterprise-blog-articles) for organization-specific details. @@ -30,7 +30,7 @@ When creating the article, pick the namespace it should be published under from ## Editing an Article - Articles published under a user namespace can be edited by the original author and any coauthors listed on the article. -- Articles published under an organization namespace can be edited by any organization member with `write` or `admin` role (or a custom role with `WriteBlog`). +- Articles published under an organization namespace can be edited by any organization member with `write` or `admin` role. ## Linking to Models and Datasets From 17a287c480442eb4dec488fff64a300cf1d7fdb7 Mon Sep 17 00:00:00 2001 From: Mishig Date: Mon, 18 May 2026 19:33:54 +0200 Subject: [PATCH 4/6] Dedupe linking section; reference canonical blog-articles doc Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/hub/enterprise-blog-articles.md | 4 +--- docs/hub/models-faq.md | 4 +--- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/docs/hub/enterprise-blog-articles.md b/docs/hub/enterprise-blog-articles.md index 0527ba156a..0c71c9cc5c 100644 --- a/docs/hub/enterprise-blog-articles.md +++ b/docs/hub/enterprise-blog-articles.md @@ -18,8 +18,6 @@ To publish blog articles under an organization namespace, members need `write` o ## Linking to Models and Datasets -When a blog article mentions a model or dataset owned by the same organization, the article will automatically appear in the sidebar of that model or dataset page under **"Article(s) mentioning [repo-id]"**. Up to three of the most recent matching articles are shown, making it easy for visitors to discover your organization's related content directly from the repository page. - -This also works for any models or datasets that belong to a [Collection](./collections) mentioned in the article — each member repo of a linked collection will surface the article on its page. +Articles mentioning a model or dataset owned by the same organization will automatically surface on that repo's page. See [Linking to Models and Datasets](./blog-articles#linking-to-models-and-datasets) for details. See [Blog Articles](./blog-articles) for general information about authoring blog articles on the Hub. diff --git a/docs/hub/models-faq.md b/docs/hub/models-faq.md index 815c8e7196..78bd029b02 100644 --- a/docs/hub/models-faq.md +++ b/docs/hub/models-faq.md @@ -24,9 +24,7 @@ Spaces are a great way to show off a model you've made or explore new ways to us ## Are community blog articles linked to models? -If you publish a [blog article](./blog-articles) that mentions a model and you are the same user or organization as the model's owner, the article will automatically appear in the model page sidebar under **"Article(s) mentioning [model-id]"**. Up to three of the most recent matching articles are shown. - -This makes it easy for visitors to discover related write-ups, release announcements, and research notes alongside the model itself. The same behavior applies to dataset pages. +Yes — if you publish a [blog article](./blog-articles) that mentions a model you own (as a user or organization), it will automatically appear in the model page sidebar. The same applies to dataset pages. See [Linking to Models and Datasets](./blog-articles#linking-to-models-and-datasets) for details. ## How do I upload an update / new version of the model? From 00b9df70485424e2afe8f660dd2d1efaed529da5 Mon Sep 17 00:00:00 2001 From: Mishig Date: Tue, 19 May 2026 10:09:31 +0200 Subject: [PATCH 5/6] Update docs/hub/blog-articles.md Co-authored-by: Pierric Cistac --- docs/hub/blog-articles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hub/blog-articles.md b/docs/hub/blog-articles.md index 7f8c5633ce..ab8811886e 100644 --- a/docs/hub/blog-articles.md +++ b/docs/hub/blog-articles.md @@ -9,7 +9,7 @@ To publish under **your personal namespace**, you need a confirmed email and mus - You have an active [PRO](./pro) subscription. - You are a member of a [Team or Enterprise](https://huggingface.co/enterprise) organization (with `write` or `admin` role in that organization). -Managed users (users provisioned through Enterprise SSO) cannot publish under their personal namespace. +Managed users (users provisioned through Enterprise IdP) cannot publish under their personal namespace. To publish under an **organization namespace**, both must hold: From a43876b7a579d9031a64b163da37538f23ca0346 Mon Sep 17 00:00:00 2001 From: Mishig Date: Wed, 20 May 2026 11:30:12 +0200 Subject: [PATCH 6/6] Add screenshots to blog articles doc Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/hub/blog-articles.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/hub/blog-articles.md b/docs/hub/blog-articles.md index ab8811886e..d4e0234f63 100644 --- a/docs/hub/blog-articles.md +++ b/docs/hub/blog-articles.md @@ -27,6 +27,11 @@ When creating the article, pick the namespace it should be published under from - **Your username** — the article appears on your user profile. - **An organization** — the article appears on that organization's profile page. +
+ + +
+ ## Editing an Article - Articles published under a user namespace can be edited by the original author and any coauthors listed on the article. @@ -36,6 +41,11 @@ When creating the article, pick the namespace it should be published under from When a blog article mentions a model or dataset, and the article's author (user or organization) is the same as the repo's owner, the article will automatically appear in the sidebar of that model or dataset page under **"Article(s) mentioning [repo-id]"**. Up to three of the most recent matching articles are shown. +
+ + +
+ This makes it easy for visitors to discover related write-ups, release announcements, and research notes alongside the repository itself. If the article references a [Collection](./collections), every model and dataset in that collection is treated as linked — the article will surface on each member repo's page (subject to the same ownership rule).