# Known limitations By design, Quilt is backed by Amazon S3 and scales to billions of objects and petabytes of data. The underlying limitations of S3 apply. The Quilt catalog can browse packages and S3 buckets of any size. ## Catalog push To ensure usability and quick package pushes, the Quilt web catalog imposes the following limits on pushes. These limits do not apply to the `quilt3` Python API. | Dimension | Max | | ---------------------------------------------------------- | ------ | | Package manifest size (metadata) | 100 MB | | Package size (data; via promotion or from an S3 directory) | 100 GB | | Total size of uploaded files (soft limit) | 20 GB | | Total size of files from S3 (soft limit) | 50 GB | | Maximum file size | 10 GB | | Maximum number of files per push (soft limit) | 1,000 | | Maximum number of files per push (hard limit) | 5,000 | ## API As of this writing, with sufficient client-side memory, you can comfortable scale Quilt packages to at least one million objects per package, with no practical limit on object size (save S3's 5 TB per object limit). A fast network, or better yet an AWS compute instance in the same region as your Quilt S3 buckets, is recommended. ## Metadata See [Metadata](/version-5.0.x/catalog/metadata.md). --- # 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/version-5.0.x/api-reference/limitations.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.