Data version 2026-11-09
Unit conversion datasets
Download the unit definitions and conversion factors behind every ConvertReference converter. The files are public domain under CC0 1.0: use them in software, spreadsheets, research or training data without asking or crediting us.
Downloads
| File | Rows | Size | Contents |
|---|---|---|---|
units.csv | 123 rows | 12 KB | One row per unit: id, name, symbol, quantity, system, SI unit, value in the SI unit, whether that value is exact, the exact fraction, temperature offset and the definition. |
conversions.csv | 1,514 rows | 157 KB | Every pair of units within each quantity, with the factor, whether it is exact, the exact fraction, the formula and the converter page when there is one. |
units.json | — | 49 KB | The full registry as JSON, with notes on conventions and the list of units in each quantity. |
converters.json | — | 39 KB | Every converter page on the site with its JSON file. |
The same data is published as individual JSON files — one per unit and one per unit pair — through the API.
What is in it
123 units in 12 quantities: length, area, volume, mass, time, speed, pressure, temperature, energy, power, force, digital storage. Each unit is defined by its exact relationship to the SI unit, taken from the standard that defines it — the 1959 international yard and pound agreement, the SI Brochure, NIST Special Publication 811, the IAU and CODATA.
Factors are worked out as exact fractions, never in floating point. Where a factor has a finite decimal it is given in full and marked exact; where it does not (1/25.4, for example) it is given to 21 significant digits and the exact fraction is included alongside.
Here are the first rows of conversions.csv:
from,to,quantity,factor,factor_exact,factor_rational,formula,page
meter,kilometer,length,0.001,true,1/1000,y = x × 0.001,https://convertreference.org/length/meter-to-kilometer/
meter,centimeter,length,100,true,100,y = x × 100,https://convertreference.org/length/centimeter-to-meter/
meter,millimeter,length,1000,true,1000,y = x × 1000,https://convertreference.org/length/millimeter-to-meter/
Conventions to be aware of
- Gallon, quart, pint, cup, fluid ounce, tablespoon and teaspoon are US customary units; imperial gallon and pint are separate units.
tonis the US short ton (2000 lb);metric_tonandlong_tonare separate.- Year is the Julian year of 365.25 days and month is one twelfth of it.
- Acre, chain, furlong, fathom and league use the international foot. The US survey foot was retired on 1 January 2023.
- Temperature is affine: kelvin = (value + offset) × factor. Convert temperature differences with the factor only.
- Parsec, Bohr radius and Planck length are not exactly defined in SI terms and have no exact fraction.
Load it in a few lines
import pandas as pd
units = pd.read_csv("https://convertreference.org/datasets/units.csv")
pairs = pd.read_csv("https://convertreference.org/datasets/conversions.csv")
pairs[(pairs["from"] == "acre") & (pairs["to"] == "hectare")]Updates and corrections
The files are rebuilt from the registry on every site deploy, so they always match the converters. The data version changes whenever a definition changes. The current version, 2026-11-09, moved the acre and the chain, furlong, fathom and league from the retired US survey foot to the international foot, and added temperature, energy, power, force and digital storage units.
Found a problem? Tell us through Editorial & corrections.