The widget lets you browse S3-compatible object storage, including Amazon S3, Yandex Object Storage, and MinIO.
For each object, you can:
- View objects in a bucket with their size, modification date, and storage class.
- Search for objects by prefix (path).
- Download files from the bucket.
- View object metadata, including size, content type, custom metadata, and cache settings.
- Navigate bucket folders.
Using credential templates
You can use credential templating:
{{ .credentials.accessKeyId }}— Inserts the Access Key ID from the credentials.{{ .credentials.secretAccessKey }}— Inserts the Secret Access Key from the credentials.
The connected account’s permissions determine what information is available in the widget.
Configuration
| Name | Required | Description | Default |
|---|---|---|---|
| Bucket name | Yes | Name of the S3 bucket to browse | — |
| Endpoint | Yes | S3-compatible storage endpoint URL, for example, https://storage.yandexcloud.net | — |
| Region | Yes | Region containing the bucket | — |
| Access Key ID | Yes | Access key identifier used for authentication | — |
| Secret Access Key | Yes | Secret access key used for authentication | — |
| Prefix | No | Prefix (path) used to filter objects on initial load | — |
| Maximum objects | No | Maximum number of objects displayed per request | 100 |
Additional widget features
Object search
The widget searches for objects by prefix (path). The object list updates to match the specified prefix.
Search matches only characters at the beginning of an object name. Searching by characters in the middle of a name is not supported.
If the widget configuration specifies an initial prefix, searches are restricted to that prefix. Files with other prefixes cannot be loaded or displayed.
Downloading files
The widget lets you download files from a bucket directly in the browser. A download button is available for each file.
Object details
Select the document icon for an object to view:
- Basic properties: key, size, modification date, storage class, content type, and ETag.
- Content information: encoding, language, and disposition.
- Cache settings: Cache-Control and expiration.
- Security: server-side encryption.
- Custom metadata.
Loading more objects
For buckets containing many objects, use Load more to load objects incrementally without reducing performance.
Authentication
The widget requires credentials with access to the S3 bucket. It supports:
- Access Key ID and Secret Access Key.
- Different S3-compatible providers through endpoint configuration.
Unlike other widgets, the S3 widget cannot obtain credentials from external services. Specify all authentication parameters directly in the widget configuration.