Objects
An object is a single file stored in a bucket, together with its details: size, content type and last-modified date. Each object is found by its key, the full name inside the bucket, such as reports/2026/may.pdf. This page shows how to upload, download, organize and delete objects in the portal and with S3 tools.
When to use the portal or an S3 tool
How it works
- An upload writes the whole file under its key. Uploading to a key that already exists replaces the file.
- “Folders” are just the part of a key before a
/. The portal shows them as folders so you can browse. - A download reads the whole file, or a byte range of it.
Before you begin
- A bucket. See Create a bucket.
- For the portal: write access to the workspace (without it, Upload and Create Folder aren’t shown).
- For S3 tools: an S3 credential with Object Read & Write (or Admin Read & Write) for the bucket, and the AWS CLI set up with region
autoand path-style addressing as in Using the S3 API.
Upload in the portal
Choose the files
Click Upload to pick files, or open the arrow next to it and choose Upload files or Upload folder. You can also drag files onto the list. An empty bucket or folder shows Upload Files and Upload Folder buttons instead.
Upload and download with the AWS CLI
These commands use the ibee profile from Using the S3 API. Replace WORKSPACE-ID with your endpoint’s ID.
The AWS CLI and SDKs switch to a multipart upload — sending a big file in parts, in parallel — for large files. You don’t need to do anything; just remember the limits of 10,000 parts of up to 5 GiB each.
To set the content type a browser sees (for example for website files), add --content-type "text/html" to aws s3 cp.
Folders
Create one in the portal with Create Folder: enter a Folder Name (placeholder my-folder) of letters, numbers, hyphens and underscores, and click Create Folder. It’s created inside the folder you have open.
Behind the scenes a folder is an empty object whose key ends in /. With S3 tools you don’t need to create folders first: uploading to photos/2026/beach.jpg makes photos/ and photos/2026/ appear.
Download, view and share
- Download: click the download icon on the object’s row.
- Details: click the object’s name to see its Name, Size, Type, Modified date and Access (Public or Private). Images show a Preview.
- Public link: in a public bucket with a Public Access URL, the details show the object’s Public Development URL, with a copy button. It’s rate-limited and meant for testing; use a custom domain for production.
- Private link: create a presigned URL.
Delete objects
Deleted objects can’t be recovered unless the bucket was created with Object Lock (which keeps versions). Check before you delete.
- One file: click the delete icon on its row and confirm.
- Several files: tick their boxes, click Delete in the toolbar (it shows how many are selected), and confirm. Clear selection cancels.
- Everything: use Empty bucket, or
aws s3 rm s3://my-bucket --recursivefor buckets with Object Lock or versioning.
Objects under a legal hold or retention period can’t be deleted; see Object Locking.
Verify
- The portal list shows the file with the expected Size.
aws s3 ls s3://my-bucket/reports/ …lists the key.aws s3api head-object --bucket my-bucket --key reports/2026-05.pdf …prints itsContentLength,ContentTypeandETag(a fingerprint of the content).
