Skip to content
RuleRoster

Source-backed platform rule

PyPI first-file release creation

PyPI creates a new release from the first file uploaded for a version and uses that file to populate release metadata.

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

Direct answer

What is the rule?

For a version not yet on PyPI, the first uploaded file creates the release and populates its metadata.

Scope
PyPI publishing and release behavior
Human verified
August 14, 2026
Source checked
September 3, 2026

Published evidence

Rule details

First-file release creation

The upload API accepts one file at a time. For a new version, the first uploaded file creates the release and populates its metadata. Metadata immutability is not stated.

Applicability

Service: PyPI Upload API. Route: POST upload.pypi.org/legacy/. Version state: new version. 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-14. 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 14, 2026
Source checked
September 3, 2026
Review due
September 4, 2026

Challenge this record

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

Submit a correction