Skip to content

[Spaces]: add Spaces attached volumes documentation #2377

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mishig25 wants to merge 5 commits into
base: main
Choose a base branch
from
Open

[Spaces]: add Spaces attached volumes documentation #2377

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
a90d624
docs: add Spaces attached volumes section to storage docs
mishig25 Apr 12, 2026
168c116
docs: add light/dark screenshots for attached volumes
mishig25 Apr 13, 2026
3b8fa5d
docs: set width=300 for attached volumes screenshots
mishig25 Apr 13, 2026
6061ba8
docs: use max-width on container div instead of width on img
mishig25 Apr 13, 2026
a1d9100
docs: merge Storage Buckets and Attached Volumes sections
mishig25 Apr 13, 2026
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
17 changes: 15 additions & 2 deletions docs/hub/spaces-storage.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,26 @@
Every Space comes with a small amount of disk storage. This disk space is ephemeral, meaning its content will be lost if your Space restarts or is stopped.
If you need to persist data with a longer lifetime than the Space itself, you can attach one (or more) Storage Buckets.

## Storage Buckets
## Attached Volumes

[Storage Buckets](./storage-buckets) are the recommended way to persist data in your Space. You can attach a bucket when creating a Space or from the Space settings later. The bucket is mounted into your Space and can be used to store files that persist across restarts.
Spaces can mount [Storage Buckets](./storage-buckets) and Hugging Face repositories (models, datasets, other Spaces) as volumes. These volumes are mounted into the Space container at the paths specified during configuration, making their contents available as local files at runtime.

Storage Buckets are the recommended way to persist data. You can attach a bucket when creating a Space or from the Space settings later.

<div class="flex justify-center">
<img class="block dark:hidden" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-attach-bucket.png"/>
<img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-attach-bucket-dark.png"/>
</div>

See the [Storage Buckets documentation](./storage-buckets) for full details on creating and using buckets.

### Viewing attached volumes

The Space page displays attached volumes in the actions dropdown. Each volume shows its source repository or bucket, its mount path inside the container, and whether it is mounted as read-only or read-write.

<div class="flex justify-center" style="max-width: 300px">
<img class="block dark:hidden" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-attached-volumes-light.png"/>
<img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-attached-volumes-dark.png"/>
Comment on lines +24 to +25
Copy link
Copy Markdown
Contributor

@kefranabg kefranabg Apr 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Eventually we can use those screenshots to display more context but no strong opinions
Image
Image

</div>

When a volume references a private repository, users without access will still see the volume listed (with its mount path and access mode), but the source will be masked as `****/******` with a "(private)" label.
Loading