papersizes-guide
Every standard paper size, offline. No network calls, no API key, no dependencies.
Covers 324 sizes across 23 series: ISO A, B and C, US and ANSI, ARCH, envelopes, photo prints, business and ID cards, book trim sizes, newspapers, billboards, and regional standards from Japan, China, France, Canada, Colombia and the British Imperial system.
pip install papersizes-guide
Use
import papersizes_guide as paper
a4 = paper.get("A4")
a4.width_mm # 210.0
a4.height_in # 11.69
a4.pixels(300) # (2480, 3508)
a4.ratio_label # '1:√2'
a4.weight(80) # 4.992 (grams, one sheet at 80 gsm)
Look a size up by slug, name or alias:
paper.get("a4")
paper.get("DIN A4")
paper.get("No. 10 envelope")
Identify a sheet you have measured. Orientation does not matter:
paper.find(8.5, 11, unit="in")[0].size.name # 'Letter'
paper.find(216, 356)[0].size.name # 'Legal'
paper.find(297, 210)[0].rotated # True — that is A4, turned
Work with a whole series:
[s.name for s in paper.series("a")] # A0 … A10, plus 2A0 and 4A0
paper.series_list() # every series with its governing standard
Why derived, not stored
Only the millimetre dimensions are stored. Inches, points, pixels, ratio, area and sheet weight are properties computed on access, so the package cannot contradict itself and adding a resolution costs nothing.
API
| Call | Returns |
|---|---|
all_sizes() |
Every size |
get(name_or_slug) |
One PaperSize, or None |
find(w, h, unit="mm", limit=6) |
Nearest matches, closest first |
series(slug) |
Sizes in one series |
series_list() |
The series index |
VERSION |
Dataset version, e.g. 2026.09.07 |
Each PaperSize exposes width_mm, height_mm, width_cm, height_cm, width_in, height_in, width_pt, height_pt, ratio, ratio_label, area_mm2, area_m2, diagonal_mm, orientation, plus pixels(dpi) and weight(gsm). Frozen dataclasses, fully typed, py.typed included.
When two sizes share exact dimensions, such as Letter and ANSI A, find returns the more familiar one first.
Data and licence
The dataset comes from papersizes.guide and is released under CC BY 4.0. Use it commercially, modify it, redistribute it. The only condition is credit.
ISO and ANSI values are generated from the standard formulas rather than transcribed. Regional and historical sizes are cross-checked against at least two published references, and any size whose sources disagree carries a note on its page. The full process is documented at papersizes.guide/methodology.
To cite the dataset:
PaperSizes.guide paper size dataset, version 2026.09.07.
https://papersizes.guide/data/ — CC BY 4.0
A live REST API of the same data, with no key, is documented at papersizes.guide/data.
Found an error in a dimension? Report it and it will be corrected with the correction noted.
Source, and where to report a wrong dimension in code: github.com/nanosani/papersizes-guide.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file papersizes_guide-1.0.1.tar.gz.
File metadata
- Download URL: papersizes_guide-1.0.1.tar.gz
- Upload date:
- Size: 14.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7ff9040ade17f344207f3388e3f7a354ab856672c4c6858e1b22305eb10ca192
|
|
| MD5 |
5f4434fa741cae687f5f0070451a1f6c
|
|
| BLAKE2b-256 |
67396d908b73e7e6538c56f565adb7225a18dd3dd15033b7c831b8048d0e2e07
|
Provenance
The following attestation bundles were made for papersizes_guide-1.0.1.tar.gz:
Publisher:
release.yml on nanosani/papersizes-guide
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
papersizes_guide-1.0.1.tar.gz -
Subject digest:
7ff9040ade17f344207f3388e3f7a354ab856672c4c6858e1b22305eb10ca192 - Sigstore transparency entry: 2791751656
- Sigstore integration time:
-
Permalink:
nanosani/papersizes-guide@3b81ddf2c83f82e6eb4e517a6bb26a7a23989871 -
Branch / Tag:
refs/tags/v1.0.1 - Owner: https://github.com/nanosani
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@3b81ddf2c83f82e6eb4e517a6bb26a7a23989871 -
Trigger Event:
push
-
Statement type:
File details
Details for the file papersizes_guide-1.0.1-py3-none-any.whl.
File metadata
- Download URL: papersizes_guide-1.0.1-py3-none-any.whl
- Upload date:
- Size: 16.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
607ecf5c0f73a220362a07d59d6c5bd4efdb443c5d0a0114028a7a186d565bb5
|
|
| MD5 |
3d50141c9a5b0a3ca952acfd3d2c9880
|
|
| BLAKE2b-256 |
2fd101e32aac1f7fe387885f44ce0b32fda745e12168f76cdb29ef4b067eace2
|
Provenance
The following attestation bundles were made for papersizes_guide-1.0.1-py3-none-any.whl:
Publisher:
release.yml on nanosani/papersizes-guide
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
papersizes_guide-1.0.1-py3-none-any.whl -
Subject digest:
607ecf5c0f73a220362a07d59d6c5bd4efdb443c5d0a0114028a7a186d565bb5 - Sigstore transparency entry: 2791751676
- Sigstore integration time:
-
Permalink:
nanosani/papersizes-guide@3b81ddf2c83f82e6eb4e517a6bb26a7a23989871 -
Branch / Tag:
refs/tags/v1.0.1 - Owner: https://github.com/nanosani
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@3b81ddf2c83f82e6eb4e517a6bb26a7a23989871 -
Trigger Event:
push
-
Statement type:
