> For the complete documentation index, see [llms.txt](https://docs.quilt.bio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.quilt.bio/quilt-platform-catalog-user/filebrowser.md). # 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](/files/NTwcH295qtcgkP0RPOZh) > If desired, [this tab can be hidden](/quilt-platform-administrator/preferences.md). ### Uploading and deleting files You can upload files directly to a bucket by dragging them onto the file listing or using the **Add Files** button (including into a new subfolder). One or more files can also be deleted from the listing or via the **Organize** menu without leaving the Catalog. On versioning-enabled buckets, deletion adds a delete marker so prior versions remain available from packages; on unversioned buckets the object is permanently removed. File and directory delete buttons are hidden by default. Administrators can enable them by setting `ui.actions.deleteObject` in the [Catalog configuration](/quilt-platform-administrator/preferences.md). ### Creating packages from bucket files You can create packages directly from files already stored in S3 buckets without downloading and re-uploading them. Even without a workflow configuration file, users can create packages from files in the current bucket, either by selecting them directly or by using **Add Files from Bucket** when revising a package. To disable adding files from any bucket (including the current one), set `ui.sourceBuckets` to an empty dictionary `{}` in the [Catalog configuration](/quilt-platform-administrator/preferences.md). Package creation uses the current bucket by default. With workflow configuration, only explicit `successors` are available as destinations. See [workflow configuration](/workflows.md#cross-bucket-package-push-quilt-catalog) for details. ![Create package](/files/3o1njEDOLACMwoDNVZ60) ### 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](/files/D8inFwJDKTZn7BU9SBPT) ![Add selected files to bookmarks](/files/4BShH0qRvvQnaSz89bPY) Open the Bookmarks pane (listed in the User account menu) and optionally create a new package from the bookmarked files. ![Open bookmarks](/files/2PXqDzIStFB5YWHqISZG) ![Browse bookmarks](/files/HZnTVSoO79lfRr8Wpw2w) ### Text editor Inline editing of plain text, Markdown, JSON and YAML file formats is supported. ![Edit button](/files/EapXhUX0NVMeboju8l9K) 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](/files/ImnUfHb2Xayx87nm9TRx) ![Choose name](/files/6EPGhPAsLuTW8r02KkFF) ![Edit file](/files/Anmzkh0dMQn26toWCKpn) ### Copy URI button Files and directories include a copy-URI action on the download button, making it easy to copy an `s3://` URI for use in scripts, notebooks, and CLI workflows. ### 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](/files/wmzKHSCIcTp1PTffOApY) 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](/files/zorLNKlcNmgHRFy7pqZZ) > The AWS Glacier service is rapidly evolving and may impact the functionality of the Quilt Catalog and/or API. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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= ``` 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.