Storage Limits
PyPI imposes storage limits on the size of individually uploaded files, as well as the total size of all files in a project.
The current default limits are 100.0 MB for individual files and 10.0 GB for the entire project.
You can see your project's current size and storage limits on
the project settings page (https://pypi.org/manage/project/YOUR-PROJECT/settings/
):
File size limits
By default, PyPI limits the size of individual files to 100.0 MB. If you attempt to upload a file that exceeds this limit, you'll receive an error like the following:
Uploading sampleproject-1.2.3.tar.gz
HTTPError: 400 Client Error: File too large. Limit for project 'sampleproject' is 100 MB.
Requesting a file size limit increase
Note
Note: All users submitting feedback, reporting issues or contributing to PyPI are expected to follow the PSF Code of Conduct.
If you can't upload your project's release to PyPI because you're hitting the upload file size limit, we can sometimes increase your limit. Make sure you've uploaded at least one release for the project that's under the limit (a developmental release version number is fine). Then, file an issue and tell us:
- A link to your project on PyPI (or TestPyPI)
- The size of your release, in megabytes
- Which index/indexes you need the increase for (PyPI, TestPyPI, or both)
- A brief description of your project, including the reason for the additional size.
Project size limits
By default, PyPI limits the total size of all files in a project to 10.0 GB. If you attempt to upload a file that would exceed this limit, you'll receive an error like the following:
Uploading sampleproject-1.2.3.tar.gz
HTTPError: 400 Client Error: Project size too large. Limit for project 'sampleproject' total size is 10 GB.
Freeing up storage on an existing project
Important
Deleting and yanking are two different actions. Yanking a release or file does not free up storage space.
Warning
Deleting releases and files from your project is permanent and cannot be undone without administrative intervention.
Warning
Deletion can be very disruptive for downstream dependencies of your project, since it breaks installation for pinned versions.
Before performing a deletion, we strongly recommend that you consider the potential impact on your downstreams.
If you're hitting the project size limit, you can free up storage by removing old releases or individual files from your project. To do this:
- Navigate to the release management for your project:
https://pypi.org/manage/project/YOUR-PROJECT/releases/
; - Click on
Options
next to the release you wish to delete from;- If you wish to delete the entire release, click
Delete
; - If you wish to delete individual files from the release, click
Manage
, then use each file'sOptions
menu to delete it.
- If you wish to delete the entire release, click
Requesting a project size limit increase
Note
Note: All users submitting feedback, reporting issues or contributing to PyPI are expected to follow the PSF Code of Conduct.
If you can't upload your project's release to PyPI because you're hitting the project size limit, first remove any unnecessary releases or individual files to lower your overall project size.
If that is not possible, we can sometimes increase your limit. File an issue and tell us:
- A link to your project on PyPI (or TestPyPI)
- The total size of your project, in gigabytes
- A brief description of your project, including the reason for the additional size.