Skip to content
RuleRoster

Source-backed platform rule

PyPI distribution filename reuse

PyPI permanently reserves a distribution filename once it has been used.

RuleRoster is independent and is not affiliated with or endorsed by PyPI.

Direct answer

What is the rule?

PyPI does not allow a distribution filename to be reused, even after the project is deleted and recreated.

Scope
PyPI publishing and release behavior
Human verified
August 12, 2026

Published evidence

Rule details

Filename reuse prohibition

A distribution filename is based on the project name, version number, and distribution type. PyPI does not allow reuse even after project deletion and recreation. The usual remedy is to use a previously unused version, rebuild the distribution, and upload the new distribution.

Applicability

Service: PyPI. Filename basis: project name, version number, and distribution type. Policy version and effective dates: not stated.

Evidence trail

Official sources

Attribution and license

PyPI Warehouse documentation and templates by Warehouse contributors: https://github.com/pypi/warehouse/tree/72387a451a5dc0fd0641ba7a3add4edd882f1036. Licensed under Apache License 2.0: https://github.com/pypi/warehouse/blob/72387a451a5dc0fd0641ba7a3add4edd882f1036/LICENSE. Modified by RuleRoster: RuleRoster extracted and restructured facts into typed rule fields and concise answers. Verified 2026-08-12. No root NOTICE file was present at the reviewed revision. No endorsement by PyPI or the Python Software Foundation is implied.

Interpretation and accountability

Before you act

  1. Confirm that the scope matches your case.
  2. Keep recommendations, enforced limits, exceptions, and unstated details distinct.
  3. Open the official source before relying on the rule for a consequential decision.

Record dates

Published
August 15, 2026
Human verified
August 12, 2026
Review due
September 11, 2026

Challenge this record

If the source or summary appears wrong, submit precise evidence for human review.

Submit a correction