Browsing Storage

The Files view is the main workspace for browsing your object storage. It combines a bucket selector, a hierarchical file browser, and a detail panel that opens when you click a file.

Selecting a bucket

The bucket selector sits in the top bar, to the right of the account selector. Once you have chosen an account, the selector lists every bucket in that account. Click it and type to filter by name.

The bucket selector also offers a + Create bucket action at the bottom of the dropdown. See the create-bucket guide for details (not yet published — the option is available in the UI).

Note

You must select an account before a bucket can be selected. If no account is chosen, the bucket selector shows Select account first and is disabled.

The file browser

After you select a bucket, the file browser lists the contents of the current prefix (the root of the bucket by default). Entries are displayed in a table with two types of rows:

• Folders — prefixes that act as virtual directories. Shown with a folder icon. Clicking a folder row navigates into it.
• Files (objects) — individual objects. Shown with a file icon. Each row displays the object name, its size (formatted as KB, MB, etc.), and its last-modified timestamp.

Clicking a file row opens the Details panel on the right, where you can download, rename, move, copy a presigned URL, edit metadata, manage permissions (visibility/ACL — covered in the Visibility & ACLs section of the guide), and delete the object. See Object operations for details on the operations covered there.

Breadcrumb navigation

The breadcrumb bar at the top of the file browser shows the current path within the bucket. It always starts with root (the bucket root). Each segment is a clickable button; clicking a segment navigates directly to that prefix.

For example, navigating into photos/2024/January/ produces:

root / photos / 2024 / January

Clicking photos takes you back to the photos/ prefix; clicking root returns to the bucket root.

How objects and prefixes are listed

S3 does not have real directories — folders in S3 Manager are common prefixes returned by the S3 ListObjectsV2 API with a / delimiter. S3 Manager transforms the raw API response into a two-section listing:

• Objects whose key ends with / and matches the current prefix exactly are treated as folder placeholder keys and are hidden.
• All remaining keys at the current depth are shown as files.
• Common prefixes become folder entries.

Object names are displayed relative to the current prefix, so only the final segment of the key is shown.

Pagination (“Load more”)

S3 returns object listings in pages. If the current folder has more objects than fit in one page, a Load more button appears at the bottom of the file list. Click it to fetch the next page and append the results.

Refreshing

Navigating to a different prefix or switching the bucket reloads the listing automatically. There is no dedicated refresh button. To force a reload of the current view, navigate to the parent prefix using the breadcrumb and then click the folder to re-enter it, or switch to a different bucket and back.

Toolbar buttons

Two buttons appear in the top-right of the file browser toolbar:

• Upload link… — generates a presigned PUT URL so someone else can upload a file to the current prefix. See Presigned links.
• New folder — creates a new virtual folder (zero-byte placeholder object) at the current prefix.