# Bucket Browsing

Every S3 bucket attached to Quilt has a "Bucket" tab in the Catalog that displays all files in the bucket.

![Files browser tab](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-7aaeaa47c50df07ef0c2fdb4f20b7eafa6fd4717%2Fcatalog-filesbrowser-tab.png?alt=media)

> If desired, [this tab can be hidden](https://docs.quilt.bio/quilt-platform-administrator/preferences).

### Creating packages from bucket files

You can create packages directly from files already stored in S3 buckets without downloading and re-uploading them.

Package creation uses the current bucket by default. With workflow configuration, only explicit `successors` are available as destinations. See [workflow configuration](https://docs.quilt.bio/workflows#cross-bucket-package-push-quilt-catalog) for details.

![Create package](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-ab6cf5efd974ac53da7f5bec8e05c7819075dc5d%2Fcatalog-filesbrowser-create-package.png?alt=media)

### Bookmarks

To create a package that includes multiple files from different directories in a single S3 bucket, or even across different S3 buckets attached to Quilt, you can browse and create a "bookmark" of chosen files. Select files by checking the box and clicking "Add to bookmarks". You can also navigate to a specific file and bookmark an individual file by clicking "Add to bookmarks".

![Select files](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-668a10635af5deb22a3f0124378d60ec322dada0%2Fcatalog-filesbrowser-select.png?alt=media)

![Add selected files to bookmarks](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-c972157b5a454274be20b98c1b6aa004cf977c1f%2Fcatalog-filesbrowser-addtobookmarks.png?alt=media)

Open the Bookmarks pane (listed in the User account menu) and optionally create a new package from the bookmarked files.

![Open bookmarks](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-1f021876b131b5e39cb7a4be5e8184de581fff0a%2Fcatalog-filesbrowser-bookmarksmenu.png?alt=media)

![Browse bookmarks](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-cd2dd7992886c1bb9c99b7e122045738306cde28%2Fcatalog-filesbrowser-bookmarkspane.png?alt=media)

### Text editor

Inline editing of plain text, Markdown, JSON and YAML file formats is supported.

![Edit button](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-77b56c46d42b7cc718b7e658dfee19595d09ced4%2Fcatalog-texteditor-edit.png?alt=media)

New text files can be created individually in editable file formats. To create one, click the «kebab» menu (three vertical dots) located in the far-right, above the file browser. Choose a file name and format (the default is README.md), enter your content, and click save.

![Open menu](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-389545638695204f321427c01ce75af00a3c7586%2Fcatalog-texteditor-create.png?alt=media)

![Choose name](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-5648778e177d1ffe59452b2ef6b4962b76f8494b%2Fcatalog-texteditor-name.png?alt=media)

![Edit file](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-f805832e967386a649ba62667a601ae36e89a334%2Fcatalog-texteditor-main.png?alt=media)

### Working with Amazon S3 Glacier storage classes

Glacier storage classes are built for data archiving. Quilt is compatible with S3 bucket lifecycle rules that transition S3 objects to Glacier storage classes.

There are currently three types of S3 object archive storage class that work differently with the Quilt Catalog, `quilt3` CLI and Python API.

1. **S3 Glacier Instant Retrieval:** Objects in this storage class are available as normal in the Bucket and Packages tabs in the Quilt Catalog.
2. **S3 Glacier Flexible Retrieval (formerly S3 Glacier):** Objects are not immediately available and appear "grayed out" in the Catalog.
3. **S3 Glacier Deep Archive:** Objects are not immediately available and appear "grayed out" in the Catalog.

![Glacier S3 objects list
view](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-c43aa128aedf44ac6491a1d373b8fd18210291db%2Fcatalog-filesbrowser-glacier-listview.png?alt=media)

Previewing a specific "glacierized" S3 object returns an "Object Archived: Preview not available" message. To successfully preview the S3 object, you need to restore it first.

![Glacier S3 objects object
view](https://515699986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LDNT6ZcFbSZLsyC6aK9-887967055%2Fuploads%2Fgit-blob-b7f113d140f189ee611defd4e076fe17dda65b82%2Fcatalog-filesbrowser-glacier-objectview.png?alt=media)

> The AWS Glacier service is rapidly evolving and may impact the functionality of the Quilt Catalog and/or API.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.quilt.bio/quilt-platform-catalog-user/filebrowser.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
