hf buckets settings updates bucket visibility
Introduced 2026-08-27 · score 0.97
HOW TO USE IT
For an existing bucket, set `private=True` to make it private or `private=False` to make it public. Use `update_bucket_settings()` or `hf buckets settings` with the matching visibility option.
hf buckets settings <owner>/<bucket> --privatehf buckets settings <owner>/<bucket> --publicfrom huggingface_hub import update_bucket_settings
update_bucket_settings(bucket_id="<owner>/<bucket>", private=True)WHY THIS HELPS
Change an existing bucket from private to public or public to private.
BEFORE THIS CHANGE
Bucket visibility could only be set when creating a bucket; it could not be changed afterward.
REQUIREMENTS AND LIMITATIONS
- Version: v1.29.0
- bucket_id (required): Bucket ID, such as `<owner>/<bucket>`.
- private (required): Boolean visibility setting: `True` makes the bucket private; `False` makes it public.
- --private (required): CLI option to make the bucket private.
- --public (required): CLI option to make the bucket public.
- BUCKET_ID (required): CLI bucket ID in `namespace/bucket_name` or `hf://buckets/namespace/bucket_name` format.
- Prerequisite: Use huggingface_hub v1.29.0 or later; the release introduced updating bucket visibility.
FIRST-PARTY EVIDENCE
- https://github.com/huggingface/huggingface_hub/releases/tag/v1.29.0
- https://huggingface.co/docs/huggingface_hub/v1.29.0/en/package_reference/cli
- https://huggingface.co/docs/huggingface_hub/v1.29.0/en/package_reference/hf_api
Check the installed version and the source before using it. Entry JSON